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. 将 STUN 或 TURN 服务器的地址放在 STUN 或 TURN URI 文本框中。确保 URI scheme 采用以下格式：scheme:host:[port]。默认情况下，该工具使用 stun:stun.l.google.com:19302
  2. （可选）如果您使用的是 TURN 服务器，则需要在 TURN Username 和 Turn 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. 将“应答 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 验证工具之前打开控制台。