TsgcWSPServer_WebRTC › Métodos › Broadcast
Envía una carga útil de texto a todos los peers suscritos al canal de señalización, excluyendo o apuntando opcionalmente a conexiones específicas.
procedure Broadcast(aMessage: string; aChannel: string = ''; Exclude: String = ''; Include: String = '');| Nombre | Tipo | Descripción |
|---|---|---|
aMessage | string | Carga útil de texto entregada a los suscriptores; habitualmente una línea de chat, un aviso de sala o metadatos específicos de la aplicación que acompañan al relay SDP/ICE. |
aChannel | string | Canal (sala) al que se limita la difusión. Si está vacío, el frame se envía a todos los pares conectados independientemente de sus suscripciones. |
Exclude | String | GUID de una conexión que debe omitirse — normalmente el remitente, para que no reciba el eco de su propio mensaje. |
Include | String | GUID de una única conexión de destino: cuando se establece, solo ese par recibe el frame, anulando el fan-out del canal. |
Envuelve el texto en el sobre de señalización como un método sgc@broadcast en el canal solicitado y lo distribuye a través del servidor de suscripción base. A diferencia del relay peer-to-peer sgc@webrtc que transporta ofertas/respuestas SDP y candidatos ICE, Broadcast es un canal de chat/control a nivel de aplicación compartido por todos los suscriptores de una sala. Llámelo desde el servidor cuando necesite enviar una instantánea, un evento de moderación o un aviso fuera de banda a todos los pares que se unieron a una sala de señalización específica.
// push a room notice to every peer in channel "room-42"
WebRTCSrv.Broadcast('{"type":"notice","text":"recording started"}',
'room-42');