この翻訳は不完全です。英語から この記事を翻訳 してください。

これは実験的な機能です。本番で使用する前にブラウザー実装状況をチェックしてください。

RTCSessionDescription インターフェイスは、接続 (または接続する予定のもの) の一端と、その構成方法を記述します。それぞれの RTCSessionDescription は、どのオファー/アンサー交渉プロセスを使用するかを表す記述の type と、セッションの SDP 記述子から成ります。

The process of negotiating a connection between two peers involves exchanging RTCSessionDescription objects back and forth, with each description suggesting one combination of connection configuration options that the sender of the description supports. Once the two peers agree upon a configuration for the connection, negotiation is complete.

プロパティ

RTCSessionDescription が継承するプロパティは存在しません。

RTCSessionDescription.type 読取専用
これは RTCSdpType の列挙型であり、ディスクリプションの種類を表します。
RTCSessionDescription.sdp 読取専用
これは、セッションを説明するための SDP 形式の DOMString です。

定数

RTCSdpType

This enum defines strings that describe the current state of the session description, as used in the type property. The session description's type will be specified using one of these values.

説明
answer The SDP contained in the sdp property is the definitive choice in the exchange. In other words, this session description describes the agreed-upon configuration, and is being sent to finalize negotiation.
offer The session description object describes the initial proposal in an offer/answer exchange. The session negotiation process begins with an offer being sent from the caller to the callee.
pranswer The session description object describes a provisional answer; that is, it's a response to a previous offer or provisional answer.
rollback This special type with an empty session description is used to roll back to the previous stable state.

メソッド

RTCSessionDescription が継承するメソッドは存在しません。

RTCSessionDescription()
新しい RTCSessionDescription を返します。この引数は RTCSessionDescriptionInit ディクショナリであり (任意の) 2つの引数を含みます。これらの引数の1つまたは全て与えられなかった場合、関連するプロパティはnullに設定されます。
RTCSessionDescription.toJSON()
このオブジェクトの JSON による表現を生成して返します。生成された JSON は、typesdpを含みます。

signalingChannel.onmessage = function (evt) {
    if (!pc)
        start(false);

    var message = JSON.parse(evt.data);
    if (message.sdp)
        pc.setRemoteDescription(new RTCSessionDescription(message), function () {
            // オファーを受け取った場合、このオファーに対して応答する。
            if (pc.remoteDescription.type == "offer")
                pc.createAnswer(localDescCreated, logError);
        }, logError);
    else
        pc.addIceCandidate(new RTCIceCandidate(message.candidate),
            function () {}, logError);
};

仕様策定状況

仕様書 策定状況 コメント
WebRTC 1.0: Real-time Communication Between Browsers
RTCSessionDescription の定義
勧告候補 初回定義

ブラウザーの対応

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応 あり あり あり -moz- なし ? ?
type あり15 あり -moz- なし ? ?
sdp あり15 あり -moz- なし ? ?
RTCSessionDescription constructor あり あり あり -moz- なし ? ?
toJSON あり15 あり -moz- なし ? ?
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応 あり あり あり ? ? ? あり
type あり あり あり ? ? ? あり
sdp あり あり あり ? ? ? あり
RTCSessionDescription constructor あり あり あり ? ? ? あり
toJSON あり あり あり ? ? ? あり

関連情報

ドキュメントのタグと貢献者

このページの貢献者: mfuji09, dreissig.jahrhundert
最終更新者: mfuji09,