Google は、黒人コミュニティのための人種的公平の促進に取り組んでいます。詳細をご覧ください。
このページは Cloud Translation API によって翻訳されました。
Switch to English

ピア接続

RTCPeerConnectionは、 RTCPeerConnectionの中央インターフェースです。これは、ローカルピアとリモートピア間の接続を表し、接続を確立するために必要なすべての機能とイベントを提供します。

ピア接続の確立

WebRTC機能を実装するアプリケーションは、通常、 RTCPeerConnectionインターフェイスに大きく依存します。呼び出し側(つまり、接続を開始するピア)からは、接続を確立するプロセスは通常、次のようになります。

  1. 適切なICE構成で新しいRTCPeerConnectionインスタンスを作成します。
  2. RTCPeerConnection.createOffer()を使用してローカルSDP記述を作成します。
  3. RTCPeerConnection.setLocalDescription()を使用してローカルSDPの説明を設定します。
  4. ローカルSDP記述をリモートピアに転送します(シグナリングサービスを使用)。
  5. リスナー登録icecandidateのイベントRTCPeerConnection
  6. icecandidateイベントごとに、(シグナリングサービスを使用して)リモートピアに転送します。
  7. シグナリングサービスからの着信リモートSDP記述を待ち、 RTCPeerConnection.setRemoteDescription()を使用して設定します。
  8. シグナリングサービスからのリモートICE候補の着信を待ち、 RTCPeerConnection.addIceCandidate()を使用してそれらを追加します。

呼び出し先側では、プロセスが少し異なります。

  1. 適切なICE構成で新しいRTCPeerConnectionインスタンスを作成します。
  2. シグナリングサービスからの着信リモートSDP記述を待ち、 RTCPeerConnection.setRemoteDescription()を使用して設定します。
  3. RTCPeerConnection.createAnswer()呼び出して、リモートSDP記述の回答を作成します。
  4. (シグナリングサービスを使用して)応答をリモートピアに転送します。
  5. リスナー登録icecandidateのイベントRTCPeerConnection
  6. icecandidateイベントごとに、(シグナリングサービスを使用して)リモートピアに転送します。
  7. シグナリングサービスからのリモートICE候補の着信を待ち、 RTCPeerConnection.addIceCandidate()を使用してそれらを追加します。

このAPIの課題は、これらの操作のほとんどが非同期であるため、WebRTCアプリケーションの実際の実装が複雑になることがよくあることです。関数の多くは、プロセスの次のステップを続行する前に解決する必要があるPromiseを返します。

このAPIを使用しての開発者のメーク使用するアプリケーションを実装するときにすることが推奨されasyncしてawait (使用してリスナーに登録するのではなく、 Promise.then()これは従って、あなたのコードをより簡単にして、)。次の例を考えてみましょう。

function createAndSendOffer(peerConnection, signallingService) {
    peerConnection.createOffer()
                  .then(offer => {
                      signallingService.send({
                          type: 'offer',
                          data: offer
                      });
                  });
}

asyncawaitを使用して上記のコードを記述すると、次のようになります。

async function createAndSendOffer(peerConnection, signallingService) {
    const offer = await peerConnection.createOffer();
    signallingService.send({
        type: 'offer',
        data: offer
    });
}