DHTML：イベント・インターフェース　 編集：2017.06.28 21:48 by T.A.
→MS

RTCDataChannelEventインターフェース

これは実験段階の機能です。
　この機能は複数のブラウザで開発中の状態にあります。各ブラウザで用いるために、適切なベンダー接頭辞が必要な場合があります。互換性表をチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザの将来のバージョンで変更になる可能性があることに注意してください。
　RTCDataChannel インタフェースは、2つのピア間のコネクションの双方向データ・チャンネルを表現します。

　この種類のオブジェクトは、RTCDataChannel.createDataChannel() によって作成可能であり、また、既存の RTCPeerConnection の イベント datachannel で取得できます。
Note：　Gecko では、このAPIは標準的な RTCDataChannel の名前に変わって DataChannel と表記されています。
プロパティ
RTCDataChannel.label
読取専用。データ・チャネルを示す名前を含む DOMString を返します。この値に関して固有でなければならない制約はありません。
RTCDataChannel.ordered
読取専用。メッセージの配達順序を保証するかしないかを示す Boolean を返します。
RTCDataChannel.protocol
読取専用。利用している副プロトコルの名前を含む DOMString を返します。ない場合は「」（空文字列）を返します。
RTCDataChannel.id
読取専用。このチャンネルの固有 ID を示す unsigned short を返します。この値は、RTCDataChannel オブジェクトの作成時に設定されます。
RTCDataChannel.readyState
読取専用。下位のデータコネクションの状態を表現する列挙型の RTCDataChannelState を返します。次のいずれかの値をとります。
RTCDataChannel.bufferedAmount
読取専用。送信キューのバイト量を含む unsigned long を返します。これは、RTCDataChannel.send() を介して送信要求され、まだ送信されていないデータの量です。チャンネルが閉じている場合、バッファリングは継続することに注意してください。
RTCDataChannel.binaryType
コネクションによって送信されたバイナリーデータの種類を示す DOMString です。この値は、Blob が利用されている場合は「blob」、ArrayBuffer が利用されている場合は「arraybuffer」にすべきです。初期状態では、「blob」が設定されます。
RTCDataChannel.maxPacketLifeType
読取専用。無信頼性モードでのメッセージングでの、ミリ秒単位のウィンドウ長を示す unsigned short です。
RTCDataChannel.maxRetransmits
読取専用。無信頼性モードでのメッセージングでの、最大再送信回数を示す unsigned short です。
RTCDataChannel.negotiated
読取専用。アプリケーションによってチャンネルが交渉されたかされていないかを示す Boolean です。
DataChannel.reliable
読取専用、非標準化。コネクションはメッセージを無信頼性モードで送信可能かを示す Boolean です。
DataChannel.stream
読取専用、非標準化。旧式です。RTCDataChannel.id と同じ意味を持ちます。
イベント・ハンドラー
RTCDataChannel.onopenopen
イベントを受信した時に呼ばれるイベント・ハンドラーです。このイベントは、データ・コネクションのための下位のデータ・トランスポートが確立された時に送信されます。
RTCDataChannel.onmessagemessage
イベントを受信した時に呼ばれるイベント・ハンドラーです。このイベントは、データ・コネクション上でメッセージを受信した時に送信されます。
RTCDataChannel.oncloseclose
イベントを受信した時に呼ばれるイベント・ハンドラーです。このイベントは、下位のデータ・トランスポートが閉じた時に送信されます。
RTCDataChannel.onerrorerror
イベントを受信した時に呼ばれるイベント・ハンドラーです。このイベントは、エラーに遭遇した時に送信されます。
メソッド
RTCDataChannel.close()
チャンネルを閉じます。突然でない方法でチャンネルを閉じます。チャンネルの state は「closing」に設定され、送信されていないメッセージは送信されてから、チャンネルを閉じます。
RTCDataChannel.send()
チャンネルのパラメータに従いデータを送信します。送信可能なデータの型は DOMString または Blob、ArrayBuffer、ArrayBufferView です。
例
var pc = new RTCPeerConnection(); var dc = pc.createDataChannel("my channel"); dc.onmessage = function (event) { console.log("received: " + event.data); }; dc.onopen = function () { console.log("datachannel open"); }; dc.onclose = function () { console.log("datachannel close"); };
ブラウザの互換性
PC モバイル
特徴 Chrome Firefox (Gecko) IE Opera Safari
基本サポート (有) (有) *1 未サポート (有) ?
特徴 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート ? ? ? 未サポート ? ?
*1 このインタフェースは DataChannel で表記されており RTCDataChannel ではありません。
観よ…もまた