Integración (iframe, WebView)
Parámetros de la dirección
Sección titulada «Parámetros de la dirección»https://visio.example.org/room/<sala>?pseudo=Alix&embed=1&autoJoin=1&theme=dark#k=<clave>| Parámetro | Función | Valores |
|---|---|---|
pseudo |
Nombre mostrado. | texto |
embed |
Modo integrado, sin cabecera ni elementos superfluos. | 1 o 0 |
autoJoin |
Entrar directamente, sin sala de espera (hay que indicar el nombre). | 1 o 0 |
theme |
Tema. | light (por defecto) o dark |
bridgeName |
Nombre del canal JavaScript en la aplicación anfitriona. | por defecto: MilitantVisio |
#k= |
Clave del chat (43 caracteres base64url, 256 bits). | generada por el navegador |
Para que todas las personas integradas lean el mismo chat, la aplicación anfitriona debe darles el mismo #k=. Genera 32 bytes aleatorios en el cliente (crypto.getRandomValues), codifícalos en base64url sin =, y no envíes nunca esta clave a tu propio servidor si quieres mantener el extremo a extremo. Sin #k=, cada persona obtiene una clave distinta.
Eventos enviados a la aplicación anfitriona
Sección titulada «Eventos enviados a la aplicación anfitriona»Cada evento es un objeto { type, roomId, ...datos }. Se envía por window.parent.postMessage (iframe), por el canal bridgeName, por FlutterPostMessage, por Android y por webkit.messageHandlers[bridgeName] (iOS).
type |
Cuándo | Datos |
|---|---|---|
militant-visio-connected |
Conexión a la sala establecida. | roomId |
militant-visio-disconnected |
Conexión perdida. | roomId |
militant-visio-state |
Cambio de estado local. | userCount, isConnected, isVideoOn, isAudioOn, handRaised |
militant-visio-leave |
La persona sale de la sala. | roomId |
militant-visio-error |
Error. | message |
Ejemplo en la página anfitriona:
<iframe id="visio" allow="camera; microphone; display-capture; autoplay" src="https://visio.example.org/room/asamblea?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>El atributo allow="camera; microphone; display-capture; autoplay" es imprescindible: sin él, el navegador bloquea la cámara, el micrófono y la pantalla compartida dentro del iframe.