CameraClipPreview スキーマ

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

sdm.devices.traits.CameraClipPreview

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

フィールド

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

コマンド

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

イベント

ClipPreview

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

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

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

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

ClipPreview イベント

ペイロード

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
"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
例: 「54e55063-25e6-44a5-9aa7-704405bb1c91」
timestamp イベントが発生した時刻。 string
例: 「2019-01-01T00:00:01Z」
resourceUpdate リソースの更新に関する情報の詳細を含むオブジェクト。 object
userId ユーザーを表す難読化された一意の識別子。 string
例: 「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
resourceGroup このイベントと同様の更新が行われる可能性のあるリソースを示すオブジェクト。イベント自体のリソース(resourceUpdate オブジェクトからの)は、常にこのオブジェクト内に存在します。 object

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

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

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

プレビュー

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

エラー

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