シグナリング

シグナリングAPIを使用して、セッションに接続しているクライアント間でテキストやデータを送信する。

これらのメッセージによって、開発者は基本的なテキストチャットを構築したり、あるクライアントから別のクライアントに指示を送ったり、その他の価値ある体験を作り出すことができる。

クライアントSDKには、セッションに接続しているクライアントにシグナルを送信するメソッドが含まれている。また、シグナルを受信したときにディスパッチされるイベントも含まれています。

参照 チュートリアル で信号の送受信方法を学ぶことができる。 また REST API サーバーからクライアントにシグナルを送る。

信号ペイロード

各信号には data そして type 値はどちらも文字列である：

• data - シグナルで送信される主な情報を含む。文字列。最大長は128バイトで、文字（A-Z、a-z）、数字（0-9）、'-'、'_'、'~'のみを含む。
• type - 信号のグループ化とフィルタリングに使用できるセカンダリー・フィールド。最大長は8kb。

クライアントは data または type と定義されている。このpingシグナルは、シグナルの送信者のみを識別する。 シグナルには、シグナルを送信したクライアントを識別するプロパティも含まれます。 シグナルは、特定のクライアントに送信することも、セッションに接続しているすべてのクライアントに送信することもできます。

シグナル・デリバリー

セッションに接続されたクライアントでは、クライアントSDKはクライアントがシグナルを受信するとイベントをディスパッチします。しかし、送信側クライアントには、受信者がシグナルを受信したことを示すイベントはありません。アプリケーションで必要であれば、シグナルAPIを使用して、受信確認を送信クライアントに送り返すことができます。

Vonage ビデオサーバは、送信側クライアントから受信側クライアントに信号を中継します。シグナルは、クライアントとVonageビデオサーバ間でTCPベースのWebSocket接続を使用して送信されます。信号の配信は厳密には保証されませんが、シグナリングはTCP固有のパケット再送信機能を使用します。

シグナルイベントオーダーは、シグナルクライアントから送信されたシグナルに対して保持されますが、すべてのクライアントに対して保持されるわけではありません。例えば クライアントA セッション内のすべてのクライアントにシグナル1と2を送る。 クライアントB はシグナル3と4をセッション内のすべてのクライアントに送る。シグナル1はシグナル2の前に受信され、シグナル3はシグナル4の前に受信される。しかし 顧客Aの の前に信号を受信する。 顧客Bの 信号を送る。

参照 チュートリアル 信号の送受信方法を学ぶ