CameraSound 結構定義

Nest Cam (舊版) Nest Hub Max Nest Doorbell (舊版) 

sdm.devices.traits.CameraSound

凡是支援聲響偵測事件的裝置，都具備這項特徵。

欄位

這項特徵沒有可用的欄位。

指令

這個特質沒有可用的指令。

事件

音效

攝影機偵測到聲響。

聲響偵測事件

酬載

{
  "eventId" : "a9fa5c5e-4656-49b8-ad6f-3bec235099c5",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "OxhZLMvjiLGIzJPtRD1BLSlg-f..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

聲響偵測事件欄位

欄位 說明 資料類型
eventSessionId ID，用於識別在單一工作階段中發生的相關事件。可能用於合併事件。 string
例如：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
eventId 與事件相關聯的 ID。

搭配使用 GenerateImage 指令，即可下載與這個事件相關的攝影機圖片。

 string
例如：「OxhZLMvjiLGIzJPtRD1BLSlg-f...」

事件酬載欄位

欄位 說明 資料類型
eventId 事件的專屬 ID。 string
示例：「a9fa5c5e-4656-49b8-ad6f-3bec235099c5」
timestamp 事件發生的時間。 string
例如：「2019-01-01T00:00:01Z」
resourceUpdate 詳細說明資源更新的物件。 object
userId 代表使用者的專屬模糊 ID。 string
例如：「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
resourceGroup 這個物件會指出可能與此事件有類似更新的資源。這個物件一律會包含活動本身的資源 (來自 resourceUpdate 物件)。 object

如要進一步瞭解不同類型的事件及其運作方式，請參閱「事件」。

錯誤

系統可能會傳回下列與這項特徵相關的錯誤代碼：

錯誤訊息 遠端程序呼叫 疑難排解
無法再下載攝影機影像。 DEADLINE_EXCEEDED 事件圖片會在事件發布 30 秒後失效。請務必在期限前下載圖片。
事件 ID 不屬於攝影機。 FAILED_PRECONDITION 使用攝影機事件傳回的正確 eventID。

如需 API 錯誤代碼的完整清單，請參閱 API 錯誤代碼參考資料。