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" : "00b4bf5f-f587-458f-ab16-7fe717647a4d",
  "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
例: "00b4bf5f-f587-458f-ab16-7fe717647a4d"
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 エラーコードのリファレンスをご覧ください。