智慧型住宅攝影機串流特徵結構定義

action.devices.traits.CameraStream：這個特徵說明如何控制裝置的攝影機串流。

這種特性適用於可將影片畫面串流至智慧螢幕、支援 Chromecast 的裝置或智慧型手機。這些裝置大多是監視攝影機或嬰兒監視器。不過，這個特徵也適用於內建攝影機的複雜裝置 (例如視訊會議裝置或內建攝影機的掃地機器人)。

裝置屬性

具備此特徵的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

範例

支援多種通訊協定的攝影機，不需驗證權杖。

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

相機支援單一通訊協定，需要驗證權杖。

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

支援的串流通訊協定

這個特徵支援下列串流通訊協定：

• webrtc：WebRTC
• hls：HTTP Live Streaming
• dash：基於 HTTP 的動態自動調整串流
• smooth_stream：流暢串流
• progressive_mp4：漸進式 MP4 (多用於短片)

將 hls、dash、smooth_stream 和 progressive_mp4 通訊協定串流至 Cast 裝置 (Chromecast、智慧型螢幕和支援 Chromecast 的智慧型電視) 時，系統會啟動 Cast Web Receiver，以便處理串流並在裝置上顯示。建議開發人員建立自訂網頁接收器，以便存取偵錯工具、自訂播放器行為、自訂 UI 品牌，以及納入數據分析。如要啟用自訂接收器並停用預設接收器，請在 EXECUTE 回應的 cameraStreamReceiverAppId 欄位中，設定您註冊 Cast 應用程式時產生的接收器應用程式 ID。

如要進一步瞭解自訂網頁接收器應用程式，請參閱開發人員網站的指南。

裝置狀態

無。

裝置指令

具備此特徵的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱「意圖執行要求」。

action.devices.commands.GetCameraStream

參數

結果

非 WebRTC 結果

WebRTC 結果

範例

顯示前門監視器畫面 (預設投放接收器)。

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

顯示前門監視器畫面 (自訂投放接收器)。

{
  "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"
}

裝置 ERRORS

WebRTC 通訊協定規格

使用 WebRTC 的優點是低延遲和單向通話。WebRTC 會使用 POST 方法，其中包含 POST 主體和 JSON 格式的回應。

WebRTC 目前支援 Google Nest 智慧螢幕和 Chromecast (支援 Google TV) 裝置。

本節說明使用 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 標頭告知瀏覽器，允許在一個來源執行的網路應用程式存取不同來源的所選資源。代管 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
{}