CameraClipPreview スキーマ

Google Nest Doorbell（バッテリー式） Google Nest Doorbell（電源直結型） 

sdm.devices.traits.CameraClipPreview

このトレイトは、クリップのプレビューのダウンロードをサポートするデバイスに使用します。

フィールド

この特性に使用できるフィールドはありません。

コマンド

この特性で使用できるコマンドはありません。

イベント

ClipPreview

動画クリップをプレビューできます。

クリップのプレビューは、mp4 形式の 10 フレームの動画ファイルです。mp4 動画ファイルを表示するか、別の形式（アニメーション GIF など）にコード変換して、10 フレームの完全なシーケンスを表示するかを選択できます。クリップのプレビュー方法を選択する際は、デバイス クライアントの機能を考慮する必要があります。

このイベントは、次のイベントでサポートされています。

タイプ	要素	説明
イベント	CameraMotion トレイトのMotion イベント	カメラで動きが検出されました。
イベント	CameraPerson トレイトの Person イベント	カメラが人物を検出しました。
イベント	DoorbellChime トレイトの Chime イベント	ドアホンが押された。

eventSessionId を使用して、このイベントと関連する previewUrl を 1 つ以上のサポートされているイベントに関連付けます。

ClipPreview イベント

ペイロード

{
  "eventId" : "cac055e6-c8df-471f-94ff-6cbfd6c7e969",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

ClipPreview イベント フィールド

フィールド	説明	データ型
eventSessionId	関連イベントの単一セッションの一部として発生するイベントに割り当てられる ID。イベントの統合に使用される場合があります。	string 例: 「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
previewUrl	動画クリップをプレビューする URL。デフォルトの動画コーデックは H264 です。	string 例: 「https://previewUrl/...」

イベント ペイロード フィールド

フィールド	説明	データ型
eventId	イベントの一意の識別子。	string 例: "cac055e6-c8df-471f-94ff-6cbfd6c7e969"
timestamp	イベントが発生した日時。	string 例: "2019-01-01T00:00:01Z"
resourceUpdate	リソースの更新に関する詳細情報を示すオブジェクト。	object
userId	ユーザーを表す一意の難読化された識別子。	string 例: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup	このイベントに類似した更新が存在する可能性があるリソースを示すオブジェクト。イベント自体のリソース（resourceUpdate オブジェクトから）は、常にこのオブジェクトに存在します。	object

さまざまな種類のイベントとその仕組みの詳細については、イベントをご覧ください。

クリップをプレビューする

クリップをプレビューするには、HTTP Authorization ヘッダーで OAuth アクセス トークンを使用して previewUrl に GET 呼び出しを行います。

プレビュー

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

エラー

API エラーコードの一覧については、API エラーコードのリファレンスをご覧ください。