CameraSound スキーマ

Google Nest Cam（旧型） Google Nest Hub Max Google Nest Doorbell（旧型）

sdm.devices.traits.CameraSound

このトレイトは、サウンド検知イベントをサポートするデバイスに使用します。

フィールド

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

コマンド

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

イベント

サウンド

カメラが音を検出しました。

サウンドに関するアクティビティ

ペイロード

{
  "eventId" : "9be4b7c0-5e3f-44a8-92b1-511b51627c71",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "0Mk9vpojv-6B3x7oDjeecjMHDm..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

サウンドに関するアクティビティのフィールド

フィールド	説明	データ型
`eventSessionId`	関連する一連のイベントの 1 つのセッションの一部として発生するイベントに割り当てられる ID。イベントの統合に使用される場合があります。	`string` 例: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
`eventId`	イベントに関連付けられた ID。このイベントに関連するカメラ画像をダウンロードするには、GenerateImage コマンドで使用します。	`string` 例: "0Mk9vpojv-6B3x7oDjeecjMHDm..."

イベントペイロードのフィールド

フィールド	説明	データ型
`eventId`	イベントの一意の識別子。	`string` 例: "9be4b7c0-5e3f-44a8-92b1-511b51627c71"
`timestamp`	イベントが発生した時刻。	`string` 例: "2019-01-01T00:00:01Z"
`resourceUpdate`	リソースの更新に関する詳細情報を含むオブジェクト。	`object`
`userId`	ユーザーを表す一意の難読化された識別子。	`string` 例: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
`resourceGroup`	このイベントと同様の更新が行われる可能性があるリソースを示すオブジェクト。イベントのリソース自体（`resourceUpdate` オブジェクトから）は、常にこのオブジェクトに存在します。	`object`

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

エラー

このトレイトに関連して、次のエラーコードが返されることがあります。

エラーメッセージ	RPC	トラブルシューティング
カメラ画像をダウンロードできなくなりました。	`DEADLINE_EXCEEDED`	イベント画像は、イベントが公開されてから 30 秒後に期限切れになります。期限切れになる前に画像をダウンロードしてください。
イベント ID がカメラに属していません。	`FAILED_PRECONDITION`	カメラアクティビティから返された正しい `eventID` を使用してください。

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