WebRTC 验证工具用户指南

概览

WebRTC 验证器工具是一款基于网络的工具,旨在通过 Google Assistant 模拟 Google 智能显示屏上提供的 WebRTC 播放器。此 Web 应用利用了现代浏览器中提供的 WebRTC API。更笼统地说,WebRTC 验证器工具是一个 WebRTC 对等设备,您可以在其中流式传输数据,也可以流式传输数据。

前往 WebRTC 验证器工具

WebRTC 验证工具概览图片。

自定义 STUN/TURN 服务器

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

STUN/TURN 服务器选择框。

添加 STUN/TURN 服务器

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

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

移除 STUN/TURN 服务器

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

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

启用/停用音频发送

  1. 默认情况下,该工具会将音频作为 WebRTC 流的一部分发送。如果您想禁止发送音频,请取消选中启用音频复选框。
音频复选框

“提交”按钮

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

“提交”按钮
相机权限对话框

来自您的网络摄像头的视频输入将显示在本地视频元素中。

创建优惠 SDP

  1. 点击 Create Offer SDP(创建优惠 SDP)以生成优惠 SDP。优惠 JSON 将采用以下格式:
    {
    "action": "offer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
    

2. 现在,优惠 SDP 可以传递给 WebRTC 对等方。该代理可能是您的 Google 智能家居 WebRTC 代理,也可能是在其他浏览器上运行的 WebRTC 验证器工具。

提交答案 SDP

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

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

调试 WebRTC

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

Webrtc-Internals 页面

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

此页面会显示所有正在进行的 WebRTC 连接。此页面上生成的统计信息和指标是通过 getStats() API 收集的。

Chrome 开发者工具

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