Ir al contenido

Integración (iframe, WebView)

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.