TsgcWSPServer_WebRTC › Metodi › Broadcast
Invia un payload di testo a ogni peer sottoscritto al canale di segnalazione, con possibilità di escludere o indirizzare connessioni specifiche.
procedure Broadcast(aMessage: string; aChannel: string = ''; Exclude: String = ''; Include: String = '');| Nome | Tipo | Descrizione |
|---|---|---|
aMessage | string | Payload testuale consegnato agli abbonati; di solito una riga di chat, un avviso di stanza o metadati specifici dell'applicazione che accompagnano il relay SDP/ICE. |
aChannel | string | Canale (stanza) a cui è circoscritto il broadcast. Se vuoto, il frame viene inviato a tutti i peer connessi indipendentemente dalle loro sottoscrizioni. |
Exclude | String | GUID di una connessione da escludere — in genere il mittente, in modo che non riceva in eco il proprio messaggio. |
Include | String | GUID di una singola connessione target: quando impostato, solo quel peer riceve il frame, sovrascrivendo il fan-out del canale. |
Avvolge il testo nell'envelope di segnalazione come metodo sgc@broadcast sul canale richiesto e lo distribuisce attraverso il server di sottoscrizione di base. A differenza del relay peer-to-peer sgc@webrtc che trasporta offerte/risposte SDP e candidati ICE, Broadcast è un canale di chat/controllo a livello di applicazione condiviso da ogni subscriber di una stanza. Lo chiami dal server ogni volta che ha bisogno di inviare uno snapshot, un evento di moderazione o un avviso fuori banda a tutti i peer che hanno aderito a una specifica stanza di segnalazione.
// push a room notice to every peer in channel "room-42"
WebRTCSrv.Broadcast('{"type":"notice","text":"recording started"}',
'room-42');