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

CameraClipPreview スキーマ

Google Nest Doorbell（内蔵バッテリー・電源直結併用型） Google Nest Doorbell（電源直結型）

sdm.devices.traits.CameraClipPreview

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

フィールド

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

コマンド

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

イベント

ClipPreview

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

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

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

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

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

ClipPreview イベント

ペイロード

{
  "eventId" : "ee9b7596-18ae-427e-836b-d572b462ee6a",
  "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` 例: 「ee9b7596-18ae-427e-836b-d572b462ee6a」
`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 エラーコードの完全なリスト。