スマートホームの CameraStream トレイトのスキーマ

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: Dynamic Adaptive Streaming over HTTP
• smooth_stream: Smooth Streaming
• progressive_mp4: プログレッシブ MP4（クリップでよく使用されます）

hls、dash、smooth_stream、progressive_mp4 プロトコルを Cast デバイス（Chromecast、スマート ディスプレイ、Chromecast 対応スマートテレビ）にストリーミングする場合、Cast ウェブ レシーバーが起動してストリーミングを処理し、デバイスにレンダリングします。デベロッパーは、デバッグ ツールへのアクセスを有効にしたり、プレーヤーの動作をカスタマイズしたり、UI のブランディングをカスタマイズしたり、分析情報を含めたりするために、カスタム ウェブ レシーバーを作成することをおすすめします。カスタム レシーバーの使用を有効にしてデフォルト レシーバーの使用をオプトアウトするには、Cast アプリを登録したときに生成されたレシーバー アプリ ID を EXECUTE レスポンスの cameraStreamReceiverAppId フィールドに設定します。

カスタム ウェブ レシーバー アプリケーションについて詳しくは、デベロッパー サイトのガイドをご覧ください。

デバイスのステータス

なし。

デバイスのコマンド

このトレイトを持つデバイスは、EXECUTE オペレーションの一部として次のコマンドに応答する場合があります。EXECUTE インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

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 では、JSON 形式の POST 本文とレスポンスがある POST メソッドが使用されます。

現在、WebRTC は Google Nest スマートディスプレイと Chromecast with Google TV デバイスでサポートされています。

このセクションでは、WebRTC ストリーム プロトコルを使用する場合の要件について説明します。

WebRTC の要件と推奨事項

• 現在、Google は 1 方向（半二重）通信をサポートしています。
• バンドルと rtcp-mux をサポートする必要があります。
• (D)TLS 1.2 以降を使用する必要があります。
• トリクル ICE はサポートされていません。SDP を送信する前に、すべての ICE 候補を収集する必要があります。
• 接続が成功する可能性を高めるため、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
{}