Intégration (iframe, WebView)
Paramètres d’adresse
Section intitulée « Paramètres d’adresse »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.
Événements envoyés à l’application hôte
Section intitulée « Événements envoyés à l’application hôte »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.