CameraSound 結構定義
Nest Cam (舊版)
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 錯誤代碼參考資料。