TsgcWSPServer_WebRTC › Métodos › Broadcast
Envia um payload de texto a cada peer assinante do canal de sinalização, opcionalmente excluindo ou direcionando conexões específicas.
procedure Broadcast(aMessage: string; aChannel: string = ''; Exclude: String = ''; Include: String = '');| Name | Type | Descrição |
|---|---|---|
aMessage | string | Payload de texto entregue aos assinantes; geralmente uma linha de chat, um aviso de sala ou metadados específicos da aplicação que acompanham o relay de SDP/ICE. |
aChannel | string | Canal (sala) ao qual o broadcast está restrito. Quando vazio, o frame é enviado a todos os peers conectados, independentemente de suas assinaturas. |
Exclude | String | GUID de uma conexão que deve ser ignorada — tipicamente o remetente, para que ele não receba de volta sua própria mensagem. |
Include | String | GUID de uma única conexão de destino: quando definido, apenas aquele peer recebe o frame, sobrepondo-se ao fan-out do canal. |
Encapsula o texto no envelope de sinalização como um método sgc@broadcast no canal solicitado e o despacha através do servidor de inscrição base. Diferentemente do relé peer-to-peer sgc@webrtc que carrega ofertas/respostas SDP e candidatos ICE, Broadcast é um canal de chat/controle de nível de aplicação compartilhado por todos os assinantes de uma sala. Chame-o a partir do servidor sempre que precisar enviar um snapshot, evento de moderação ou aviso out-of-band a todos os peers que entraram em uma sala de sinalização específica.
// push a room notice to every peer in channel "room-42"
WebRTCSrv.Broadcast('{"type":"notice","text":"recording started"}',
'room-42');