Aller au contenu

Intégration (iframe, WebView)

https://visio.example.org/room/<salon>?pseudo=Alix&embed=1&autoJoin=1&theme=dark#k=<clé>
Paramètre Rôle Valeurs
pseudo Nom affiché. texte
embed Mode intégré, sans en-tête ni éléments superflus. 1 ou 0
autoJoin Entrer directement, sans salle d’attente (le pseudo doit être fourni). 1 ou 0
theme Thème. light (défaut) ou dark
bridgeName Nom du canal JavaScript côté application hôte. défaut : MilitantVisio
#k= Clé du chat (43 caractères base64url, 256 bits). générée par le navigateur

Pour que toutes les personnes intégrées lisent le même chat, l’application hôte doit leur donner le même #k=. Générez 32 octets aléatoires côté client (crypto.getRandomValues), encodez-les en base64url sans =, et ne transmettez jamais cette clé à votre propre serveur si vous voulez garder le bout en bout. Sans #k=, chaque personne obtient une clé différente.

Chaque événement est un objet { type, roomId, ...données }. Il est envoyé par window.parent.postMessage (iframe), par le canal bridgeName, par FlutterPostMessage, par Android, et par webkit.messageHandlers[bridgeName] (iOS).

type Quand Données
militant-visio-connected Connexion au salon établie. roomId
militant-visio-disconnected Connexion perdue. roomId
militant-visio-state Changement d’état local. userCount, isConnected, isVideoOn, isAudioOn, handRaised
militant-visio-leave La personne quitte le salon. roomId
militant-visio-error Erreur. message

Exemple côté page hôte :

<iframe id="visio" allow="camera; microphone; display-capture; autoplay"
src="https://visio.example.org/room/assemblee?pseudo=Alix&embed=1&autoJoin=1#k=..."></iframe>
<script>
window.addEventListener('message', (event) => {
if (event.origin !== 'https://visio.example.org') return;
if (event.data?.type === 'militant-visio-leave') {
document.getElementById('visio').remove();
}
});
</script>

L’attribut allow="camera; microphone; display-capture; autoplay" est indispensable : sans lui, le navigateur bloque la caméra, le micro et le partage d’écran dans l’iframe.