智能家居 CameraStream trait 架构

action.devices.traits.CameraStream - 此 trait 介绍了如何控制设备的摄像头数据流。

此特征属于能够将视频信息流流式传输到智能显示屏、支持 Chromecast 的设备或智能手机的设备。这些设备通常是监控摄像头或婴儿摄像头。不过，此 trait 也适用于具有摄像头的更复杂设备（例如视频会议设备或带摄像头的吸尘器机器人）。

设备属性

具有此 trait 的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅intent 执行方式。

示例

支持多种协议的相机，无需身份验证令牌。

{
  "cameraStreamSupportedProtocols": [
    "webrtc",
    "hls",
    "dash",
    "smooth_stream",
    "progressive_mp4"
  ],
  "cameraStreamNeedAuthToken": false
}

支持单个协议且需要身份验证令牌的相机。

{
  "cameraStreamSupportedProtocols": [
    "hls"
  ],
  "cameraStreamNeedAuthToken": true
}

支持的流式传输协议

此 trait 支持以下流式传输协议：

• webrtc：WebRTC
• hls：HTTP 直播
• dash：基于 HTTP 的动态自适应流式传输
• smooth_stream：流畅播放
• progressive_mp4：渐进式 MP4（主要用于剪辑）

将 hls、dash、smooth_stream 和 progressive_mp4 协议流式传输到 Cast 设备（Chromecast、智能显示屏和支持 Chromecast 的智能电视）时，系统会启动 Cast Web Receiver 来处理流式传输并在设备上呈现。建议开发者创建自定义 Web 接收器，以便访问调试工具、自定义玩家行为、自定义界面品牌，以及添加分析。如需启用自定义接收器并停用默认接收器，请在 EXECUTE 响应的 cameraStreamReceiverAppId 字段中设置您在注册 Cast 应用时生成的接收器应用 ID。

如需详细了解自定义 Web 接收器应用，请访问开发者网站的指南。

设备状态

无。

设备命令

具有此特征的设备可以在 EXECUTE 操作过程中响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅intent 执行方式。

action.devices.commands.GetCameraStream

参数

结果

非 WebRTC 结果

WebRTC 结果

示例

显示前门摄像头（默认 Cast 接收器）。

{
  "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4",
  "cameraStreamProtocol": "progressive_mp4"
}

显示前门摄像头（自定义 Cast 接收器）。

{
  "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4",
  "cameraStreamReceiverAppId": "1g2f89213hg",
  "cameraStreamAuthToken": "12657342190192783",
  "cameraStreamProtocol": "progressive_mp4"
}

显示前门摄像头（WebRTC 流式传输）。

{
  "cameraStreamIceServers": "[{\"urls\": \"stun:stun.l.partner.com:19302\"},{\"urls\":\"turn:192.158.29.39:3478?transport=udp\",\"credential\": \"JZEOEt2V3Qb0y27GRntt2u2PAYA=\",\"username\": \"28224511:1379330808\"},{\"urls\": \"turn:192.158.29.39:3478?transport=tcp\",\"credential\": \"JZEOEt2V3Qb0y27GRntt2u2PAYA=\",\"username\": \"28224511:1379330808\"}]",
  "cameraStreamSignalingUrl": "https://example.com/signaling/answer",
  "cameraStreamOffer": "o=- 4611731400430051336 2 IN IP4 127.0.0.1...",
  "cameraStreamProtocol": "webrtc"
}

设备错误

WebRTC 协议规范

使用 WebRTC 的好处是低延迟和单向通话。WebRTC 使用 POST 方法，其中包含 JSON 格式的 POST 正文和响应。

Google Nest 智能显示屏和 Chromecast（支持 Google TV）设备目前支持 WebRTC。

本部分介绍了使用 WebRTC 流协议时的要求。

WebRTC 要求和建议

• Google 目前支持单向（半双工）通信。
• 您必须支持捆绑和 rtcp-mux。
• 您必须使用 (D)TLS 1.2 或更高版本。
• 不支持涓流 ICE。 必须先收集所有 ICE 候选，然后才能发送 SDP。
• 强烈建议您添加 UDP/IPv4、TCP/IPv4、UDP/IPv6 和 TCP/IPv6 ICE 候选项，以提高成功连接的几率。

支持的视频分辨率：

• 最低：480p
• 最高：1080p

支持的视频编解码器：

• VP8
• H.264

支持的音频编解码器：

• Opus（首选编解码器）
• G.711/PCMU
• G.722

跨源资源共享

跨源资源共享 (CORS) 是一种机制，它使用额外的 HTTP 标头告知浏览器允许在一个源上运行的 Web 应用访问来自其他源的选定资源。托管 cameraStreamSignalingUrl 的服务器应返回以下标头：

Access-Control-Allow-Origin: https://www.gstatic.com

示例信号请求和响应

以下示例展示了 Google 向您的信令服务发送的请求以及 Google 收到的相应响应。

Header:

Authentication: Bearer <cameraStreamAuthToken>
Content-Type: application/json

POST body:

// When camera offer SDP is provided in the execution response, Google provides an answer SDP.
{
  "action": "answer",
  "deviceId": "123",
  "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

// When camera offer SDP is not provided in execution response, Google generates and provides an offer SDP.
{
  "action": "offer",
  "deviceId": "123",
  "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

// Close the current stream session.
{
  "action": "end"
  "deviceId": "123"
}

// Response to accept the answer SDP in the request.
Response Code : 200
{}

// Response to provide the answer SDP from the service provider.
Response Code : 200
{
  // When the camera offer SDP is not provided in the execution response,
  // Google provides the answer SDP via the signaling response.
  "action": "answer"
  "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
}

// Response to close current session.
Response Code : 200
{}