このページは Cloud Translation API によって翻訳されました。

CameraClipPreview スキーマ

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

sdm.devices.traits.CameraClipPreview

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

フィールド

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

コマンド

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

イベント

ClipPreview

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

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

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

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

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

ClipPreview イベント

ペイロード

{
  "eventId" : "63dcb59f-552d-4e63-acb3-4fdc98fcfa93",
  "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` 例: 「63dcb59f-552d-4e63-acb3-4fdc98fcfa93」
`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 エラーコードのリファレンスをご覧ください。