WriteData メソッド

接続GUIDで識別される、接続中の単一のピアへテキストペイロードを送信します。

構文

function WriteData(aGuid, aMessage: string): Boolean;

パラメータ

名前	タイプ	説明
`aGuid`	`string`	対象の接続の GUID（`OnConnect` でキャプチャされた `TsgcWSConnection.Guid` の値、またはハンドシェイク時にピアに返される値）。
`aMessage`	`string`	配信するテキストペイロード。空の `Method` と `Channel` を持つシグナリングエンベロープでラップされてから送信されます。

戻り値

その GUID のライブ接続が見つかってフレームが配信用にキューに追加された場合は True、そのようなピアが接続されていない場合は False。（Boolean）

解説

低レベルのユニキャストプリミティブ: チャンネルのサブスクリプションに関係なく、GUIDによって特定のピアをターゲットにします。これにより、確認応答、サーバー起動の招待、または直接の管理メッセージに適した呼び出しになります。ペイロードはシグナリングエンベロープにラップされるため、JavaScriptシムがそれをブラウザのアプリケーションコールバックに配信できます。それ自体はSDP offer/answerやICE候補を伝えません。それらのリレーは、クライアントがネゴシエートするときにピアツーピアのsgc@webrtcフローによって自動的にトリガーされます。

使用例


// greet the peer that just joined with a welcome payload
procedure TForm1.WebRTCConnect(Connection: TsgcWSConnection);
begin
  WebRTCSrv.WriteData(Connection.Guid, '{"type":"welcome"}');
end;

メソッドに戻る