CameraClipPreview スキーマ
Google Nest Doorbell（内蔵バッテリー・電源直結併用型）
sdm.devices.traits.CameraClipPreview
このトレイトは、クリップのプレビューのダウンロードに対応しているデバイスに使用します。
フィールド
このトレイトで使用できるフィールドはありません。
コマンド
このトレイトで使用できるコマンドはありません。
イベント
ClipPreview
動画クリップをプレビューできます。
クリップ プレビューは、mp4 形式の 10 フレームの動画ファイルです。mp4 動画ファイルを表示するか、別の形式（アニメーション GIF など）にコード変換して 10 フレーム シーケンス全体を表示するかを選択できます。クリップのプレビュー方法を選択する際は、デバイス クライアント機能を考慮する必要があります。
このイベントは、次のイベントでサポートされています。
| タイプ | 要素 | 説明 |
|---|---|---|
| イベント | CameraMotion トレイトのモーション イベント | カメラで動きが検知されました。 |
| イベント | CameraPerson トレイトの Person イベント | カメラで人物が検出されました。 |
| イベント | DoorbellChime トレイトのチャイム イベント | ドアホンが押されました。 |
eventSessionId を使用して、このイベントと関連する previewUrl を 1 つ以上のサポートされているイベントに関連付けます。
ClipPreview イベント
ペイロード
{
"eventId" : "30ab68a0-4996-4a56-8cd8-f15509a27b43",
"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 |
関連イベントの 1 回のセッションの一部として発生するイベントに与えられる ID。イベントの統合に使用できる。 | string例: 「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」 |
previewUrl |
動画クリップをプレビューする URL。デフォルトの動画コーデックは H264 です。 | string例: 「https://previewUrl/...」 |
イベント ペイロードのフィールド
| 項目 | 説明 | データの種類 |
|---|---|---|
eventId |
イベントの一意の識別子。 | string例: 「30ab68a0-4996-4a56-8cd8-f15509a27b43」 |
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 エラーコード リファレンスをご覧ください。