CameraClipPreview スキーマ

Google Nest Doorbell（Battery Type） Google Nest Doorbell（電源直結型） 

sdm.devices.traits.CameraClipPreview

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

フィールド

このトレイトで使用できるフィールドはありません。

コマンド

このトレイトで使用できるコマンドはありません。

イベント

ClipPreview

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

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

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

タイプ	要素	説明
イベント	CameraMotion トレイトのモーション イベント	カメラで動きが検知されました。
イベント	CameraPerson トレイトの Person イベント	カメラで人物が検出されました。
イベント	DoorbellChime トレイトのチャイム イベント	ドアホンが押されました。

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

ClipPreview イベント

ペイロード

{
  "eventId" : "1049fe69-8e1d-4381-ad42-c7f32a90d1af",
  "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 例: 「1049fe69-8e1d-4381-ad42-c7f32a90d1af」
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 エラーコードの完全なリスト。