WebRTC 検証ツール ユーザーガイド

概要

WebRTC 検証ツールは、Google Assistant を使用して Google スマートディスプレイで使用できる WebRTC プレーヤーをエミュレートするためのウェブベースのツールです。このウェブ アプリケーションは、最新のブラウザで使用できる WebRTC API を利用しています。より一般的には、WebRTC 検証ツールは、そこからのストリーミングが可能な WebRTC ピアです。

WebRTC 検証ツールに移動

WebRTC 検証ツールの外観。

STUN / TURN サーバーをカスタマイズする

WebRTC 検証ツールは、デフォルトでは Google STUN サーバーを使用します。WebRTC 検証ツールは、ユーザー定義の STUN/TURN サーバーを使用できます。

STUN / TURN サーバーの選択ボックス。

STUN / TURN サーバーを追加する

  1. STUN または TURN サーバーのアドレスを、[STUN or TURN URI](STUN または TURN URI)テキスト ボックスに入力します。URI スキームが scheme:host:[port] 形式であることを確認します。デフォルトでは、stun:stun.l.google.com:19302 を使用します。
  2. (省略可)TURN サーバーを使用する場合は、[TURN Username](TURN ユーザー名)と [TURN Password](TURN パスワード)に認証情報を入力する必要があります。
  3. [Add Server](サーバーを追加)をクリックして、サーバーの情報をツールに追加します。

STUN / TURN サーバーは、このリストの上位から順に使用されます。

STUN / TURN サーバーを削除する

  1. 削除する STUN / TURN サーバーを選択します。
  2. [Remove Server](サーバーを削除)をクリックします。

他の STUN/TURN サーバーが指定されていない場合は、stun:stun.l.google.com:19302 が使用されます。

音声の送信を有効または無効にする

  1. WebRTC 検証ツールは、デフォルトでは WebRTC ストリームの一部として音声を送信します。音声の送信を無効にするには、[Enable Audio] チェックボックスをオンにします。
音声のチェックボックス

送信ボタン

STUN/TURN サーバーと音声の設定を確認したら、[Submit] をクリックします。

送信ボタン
カメラの権限ダイアログ

ウェブカメラから入力された動画は、ローカルの動画要素に表示されます。

Offer SDP を作成する

  1. Offer SDP を生成するには、[Create Offer SDP](Offer SDP を作成)をクリックします。Offer JSON の形式は
    {
    "action": "offer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
    
    です。

2. これで、Offer SDP を WebRTC ピア(Google スマートホームの WebRTC エージェント、または別のブラウザで実行している WebRTC 検証ツール)を使用できます。

Answer SDP を送信する

  1. [Answer SDP] テキスト ボックスに Answer JSON を入力し、[Submit Answer SDP] をクリックします。Answer JSON は、次のような形式にする必要があります。

    {
    "action": "answer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
    
  2. Answer SDP が有効な場合、リモートソースからの動画(と音声)がリモートの動画要素に表示されます。

WebRTC をデバッグする

WebRTC 検証ツールは、Chrome ブラウザ(バージョン 87 以降)で使用することを強くおすすめします。WebRTC ストリームのデバッグには、Chrome ブラウザのツールが役立ちます。

Webrtc-Internals ページ

  1. Chrome ブラウザで新しいタブを開きます。
  2. chrome://webrtc-internals にアクセスします。
WebRTC Inspect ウィンドウ

このページには、実行中の WebRTC 接続がすべて表示されます。このページで生成される統計情報と指標は、getStats() API から収集されます。

Chrome デベロッパー ツール

WebRTC ストリームに関する問題の解決には、Chrome デベロッパー ツールも便利です。WebRTC 検証ツールを使用する前に、コンソールを開くことを強くおすすめします。