CameraClipPreview スキーマ

Google Nest Doorbell(Battery Type) Google Nest Doorbell(電源直結型) 

sdm.devices.traits.CameraClipPreview

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

フィールド

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

コマンド

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

イベント

ClipPreview

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

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

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

タイプ 要素 説明
イベント CameraMotion トレイトのモーション イベント カメラで動きが検知されました。
イベント CameraPerson トレイトの Person イベント カメラで人物が検出されました。
イベント DoorbellChime トレイトのチャイム イベント ドアホンが押されました。
eventSessionId を使用して、このイベントと関連する previewUrl を 1 つ以上のサポートされているイベントに関連付けます。

ClipPreview イベント

ペイロード

{
  "eventId" : "1049fe69-8e1d-4381-ad42-c7f32a90d1af",
"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
例: 「1049fe69-8e1d-4381-ad42-c7f32a90d1af」
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 エラーコードの完全なリスト。