CameraSound 結構定義

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

sdm.devices.traits.CameraSound

這項特徵屬於所有支援聲響偵測事件的裝置。

欄位

此特徵沒有可用的欄位。

指令

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

活動

音效

攝影機偵測到聲響。

聲響偵測事件

酬載

{
  "eventId" : "0b0f23f4-9bab-450c-be75-cea2a5616216",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraSound.Sound" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "gpCTMn9-oxfMhHqbyG-lgXlj_g..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

聲響事件欄位

欄位 說明 資料類型
eventSessionId 指派給事件的 ID,此 ID 會在單一工作階段中發生相關事件。可用於合併事件。 string
範例:「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
eventId 與事件相關聯的 ID。

搭配 GenerateImage 指令使用,即可下載與這個事件相關的相機圖像。

string
範例:「gpCTMn9-oxfMhHqbyG-lgXlj_g...」

事件酬載欄位

欄位 說明 資料類型
eventId 事件的專屬 ID。 string
範例:「0b0f23f4-9bab-450c-be75-cea2a5616216」
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 錯誤代碼參考資料