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

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

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

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

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

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

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

送信ボタン

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] テキスト ボックスに回答 JSON を配置し、[Submit AnswerSDP] をクリックします。Answer JSON は、次のような形式にする必要があります。

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

WebRTC をデバッグする

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

Webrtc-Internals ページ

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

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

Chrome デベロッパー ツール

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