CameraClipPreview スキーマ

Google Nest Doorbell(バッテリー式) 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 エラーコードのリファレンスをご覧ください。