CameraClipPreview スキーマ
Google Nest Doorbell(バッテリー式)
sdm.devices.traits.CameraClipPreview
このトレイトは、クリップのプレビューのダウンロードをサポートするデバイスに使用します。
フィールド
この特性に使用できるフィールドはありません。
コマンド
この特性で使用できるコマンドはありません。
イベント
ClipPreview
動画クリップをプレビューできます。
クリップのプレビューは、mp4 形式の 10 フレームの動画ファイルです。mp4 動画ファイルを表示するか、別の形式(アニメーション GIF など)にコード変換して、10 フレームの完全なシーケンスを表示するかを選択できます。クリップのプレビュー方法を選択する際は、デバイス クライアントの機能を考慮する必要があります。
このイベントは、次のイベントでサポートされています。
タイプ | 要素 | 説明 |
---|---|---|
イベント | CameraMotion トレイトのMotion イベント | カメラで動きが検知されました。 |
イベント | CameraPerson トレイトの Person イベント | カメラで人物が検出されました。 |
イベント | DoorbellChime トレイトの Chime イベント | ドアホンが押されました。 |
eventSessionId
を使用して、このイベントと関連する previewUrl
を 1 つ以上のサポート対象イベントに関連付けます。
ClipPreview イベント
ペイロード
{ "eventId" : "daf12dfd-627f-4e7f-864c-dc6de1884531",
"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 例: "daf12dfd-627f-4e7f-864c-dc6de1884531" |
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 エラーコードのリファレンスをご覧ください。