欢迎使用 Google Home 开发者中心,这是一个学习如何开发智能家居 Action 的新平台。注意:构建 Action 的工作仍需在 Actions 控制台中完成。

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 验证工具。