Enkorpigo (iframe, WebView)
Parametroj de la adreso
Sekcio titolita “Parametroj de la adreso”https://visio.example.org/room/<salono>?pseudo=Alix&embed=1&autoJoin=1&theme=dark#k=<ŝlosilo>| Parametro | Rolo | Valoroj |
|---|---|---|
pseudo |
Montrata nomo. | teksto |
embed |
Enkorpigita reĝimo, sen kapo nek superfluaj elementoj. | 1 aŭ 0 |
autoJoin |
Eniri rekte, sen atendejo (la nomo devas esti donita). | 1 aŭ 0 |
theme |
Temo. | light (defaŭlte) aŭ dark |
bridgeName |
Nomo de la JavaScript-kanalo ĉe la gastiga aplikaĵo. | defaŭlte: MilitantVisio |
#k= |
Ŝlosilo de la babilejo (43 base64url-signoj, 256 bitoj). | kreita de la retumilo |
Por ke ĉiuj enkorpigitaj personoj legu la saman babilejon, la gastiga aplikaĵo devas doni al ili la saman #k=. Kreu 32 hazardajn bajtojn ĉe la kliento (crypto.getRandomValues), kodu ilin en base64url sen =, kaj neniam sendu tiun ŝlosilon al via propra servilo, se vi volas konservi la fino-al-finan ĉifradon. Sen #k=, ĉiu persono ricevas malsaman ŝlosilon.
Eventoj senditaj al la gastiga aplikaĵo
Sekcio titolita “Eventoj senditaj al la gastiga aplikaĵo”Ĉiu evento estas objekto { type, roomId, ...datumoj }. Ĝi estas sendata per window.parent.postMessage (iframe), per la kanalo bridgeName, per FlutterPostMessage, per Android kaj per webkit.messageHandlers[bridgeName] (iOS).
type |
Kiam | Datumoj |
|---|---|---|
militant-visio-connected |
Konekto al la salono establita. | roomId |
militant-visio-disconnected |
Konekto perdita. | roomId |
militant-visio-state |
Ŝanĝo de la loka stato. | userCount, isConnected, isVideoOn, isAudioOn, handRaised |
militant-visio-leave |
La persono forlasas la salonon. | roomId |
militant-visio-error |
Eraro. | message |
Ekzemplo ĉe la gastiga paĝo:
<iframe id="visio" allow="camera; microphone; display-capture; autoplay" src="https://visio.example.org/room/kunveno?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>La atributo allow="camera; microphone; display-capture; autoplay" estas nepra: sen ĝi, la retumilo blokas la kameraon, la mikrofonon kaj la ekrankundividon en la iframe.