CameraClipPreview スキーマ

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

sdm.devices.traits.CameraClipPreview

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

フィールド

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

コマンド

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

イベント

ClipPreview

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

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

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

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

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

ClipPreview イベント

ClipPreview イベント フィールド

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

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

フィールド	説明	データ型
eventId	イベントの一意の識別子。	string 例: "0010793b-a7d4-4842-a1ba-5c5faed866ef"
timestamp	イベントが発生した時刻。	string 例: "2019-01-01T00:00:01Z"
resourceUpdate	リソースの更新に関する詳細情報を含むオブジェクト。	object
userId	ユーザーを表す一意の難読化された識別子。	string 例: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
resourceGroup	このイベントと同様の更新が行われる可能性があるリソースを示すオブジェクト。 イベント自体（resourceUpdate オブジェクトから）のリソースは、常にこのオブジェクトに存在します。	object

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

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

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

エラー

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