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 イベント

ClipPreview イベントのフィールド

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

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

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

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

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

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

エラー

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