WebRTC 验证工具用户指南

概览

WebRTC 验证工具是一款基于 Web 的工具，旨在使用 Google Assistant 模拟 Google 智能显示屏上提供的 WebRTC 播放器。此 Web 应用利用现代浏览器中提供的 WebRTC API。更一般地说，WebRTC 验证工具是您可以从中或向其中流式传输的 WebRTC 对等方。

前往 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 用户名和 Turn 密码文本框中输入凭据。
  3. 点击添加服务器，将服务器详细信息添加到该工具中。

系统会按照 STUN/TURN 服务器在列表中显示的顺序使用这些服务器。

移除 STUN/TURN 服务器

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

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

启用/停用音频发送

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

“提交”按钮

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

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

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

创建优惠 SDP

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

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

提交回答 SDP

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

    {
"action": "answer",
"sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

  2. 如果 Answer SDP 有效，则远程来源的视频（和音频）将显示在 Remote Video 元素中。

调试 WebRTC

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

Webrtc-Internals 页面

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

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

Chrome 开发者工具

Chrome 开发者工具还有助于排查 WebRTC 流的任何问题。强烈建议您先打开 Console，然后再使用 WebRTC 验证工具。