WebRTC 验证工具用户指南

概览

WebRTC 验证工具是一款基于网络的工具,旨在使用 Google Assistant 模拟 Google 智能显示屏上提供的 WebRTC 播放器。此 Web 应用利用现代浏览器中可用的 WebRTC API。从更笼统的角度来说,WebRTC 验证工具是一个 Web RTC 对等端,您可从中流式传输数据。

转到 WebRTC 验证工具

WebRTC 验证工具概览图片。

自定义 STUN/TURN 服务器

WebRTC 验证工具默认使用 Google STUN 服务器。WebRTC 验证工具可以使用用户定义的 STUN/TURN 服务器。

STUN/TURN 服务器选择框。

添加 STUN/TURN 服务器

  1. 将 STUN 或 TURN 服务器的地址放在 STUN TURN URI 文本框中。确保 URI 架构采用以下格式:scheme:host:[port]。默认情况下,该工具会使用 stun:stun.l.google.com:19302
  2. (可选)如果您使用的是 TURN 服务器,则需要在 TURN USERNAMETurn Password 文本框中输入凭据。
  3. 点击添加服务器,为该工具添加服务器详细信息。

STUN/TURN 服务器按照其在列表中显示的顺序使用。

移除 STUN/TURN 服务器

  1. 选择要移除的 STUN/TURN 服务器。
  2. 点击移除服务器

如果未指定其他 STUN/TURN 服务器,则该工具将使用 stun:stun.l.google.com:19302

启用/停用音频发送

  1. 默认情况下,该工具会在 WebRTC 流中发送音频。如果要停用音频发送功能,请取消选中启用音频复选框。
音频复选框

提交按钮

确认您已 STUN/TURN 服务器和音频偏好设置后,点击提交

提交按钮
相机权限对话框

摄像头输入的视频画面将显示在 Local Video Element 中。

创建优惠 SDP

  1. 点击创建优惠 SDP以生成优惠 SDP。优惠 JSON 的格式如下:
    {
    "action": "offer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
    

2. 优惠 SDP 现在可以传递给 WebRTC 对等端。这可能是您的 Google 智能家居 WebRTC 代理或网络浏览器上运行的 WebRTC 验证工具。

提交答案 SDP

  1. 将 Answer JSON 放入 Answer SDP 应答文本框中,然后点击提交答案 SDP。答案 JSON 必须采用以下格式:

    {
    "action": "answer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
    
  2. 如果应答 SDP 有效,那么远程来源中的视频(和音频)就会显示在远程视频元素中。

调试 WebRTC

强烈建议将 WebRTC 验证工具与 Chrome 浏览器(版本 87 或更高版本)搭配使用。Chrome 浏览器中的工具可以帮助调试您的 WebRTC 流。

Webrtc-Internals 页面

  1. 在 Chrome 浏览器中打开新标签页
  2. 请访问以下地址:chrome://webrtc-internals
WebRTC 检查窗口

此页面会显示所有进行中的活跃 WebRTC 连接。此页面上生成的统计信息和指标收集自 getStats() API

Chrome 开发者工具

Chrome 开发者工具也有助于排查 WebRTC 数据流的任何问题。强烈建议先使用控制台,然后再使用 WebRTC 验证工具。