CameraSound 結構定義

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

sdm.devices.traits.CameraSound

此特徵屬於支援聲響偵測事件的裝置。

欄位

沒有任何適用於這個特徵的欄位。

指令

沒有適用於這個特徵的指令。

活動

音效

攝影機偵測到聲響。

聲響事件

酬載

{
  "eventId" : "c9525c2c-001e-4767-8c1e-f81601887ee1",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "GBdNhU2pCh4yfmbLIuy5ydNKZ7..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

聲響事件欄位

欄位	說明	資料類型
eventSessionId	為事件所發生單一工作階段的一部分指定的 ID。可用於合併活動。	string 例如：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
eventId	與事件相關聯的 ID。 使用 GenerateImage 指令，下載與這個事件相關的相機圖片。	string 例如：「GBdNhU2pCh4yfmbLIuy5ydNKZ7...」

事件酬載欄位

欄位	說明	資料類型
eventId	事件的專屬 ID。	string 例如：「c9525c2c-001e-4767-8c1e-f81601887ee1」
timestamp	事件發生的時間。	string 例如：「2019-01-01T00:00:01Z」
resourceUpdate	詳細列出資源更新相關資訊的物件。	object
userId	代表使用者的不重複且經過模糊處理的 ID。	string 例如：「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
resourceGroup	這個物件代表資源可能具有與此事件類似的更新。事件本身的資源 (來自 resourceUpdate 物件) 一律會顯示在這個物件中。	object

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

錯誤

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

錯誤訊息	RPC	疑難排解
相機圖片已不再開放下載。	DEADLINE_EXCEEDED	事件圖片會在事件發布 30 秒後失效。請務必在到期前下載映像檔。
事件 ID 不屬於攝影機。	FAILED_PRECONDITION	請使用攝影機事件傳回的正確 eventID。

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