DoorbellChime 結構定義
Nest Doorbell (舊版)
sdm.devices.traits.DoorbellChime
這個特徵適用於所有支援門鈴鈴聲及相關媒體事件的裝置。
欄位
沒有任何適用於這個特徵的欄位。
指令
沒有適用於這個特徵的指令。
活動
電鈴
可更新已按下門鈴。
這個事件支援可更新的通知。從這個事件建立的現有應用程式通知,可以使用具有相同 eventThreadId
的後續事件內容更新。
電鈴活動
酬載
{ "eventId" : "6af05fd7-c9f5-4387-8942-ec8a6020660a",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime
" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "FvtxwFMZgjEpB_uEyJ8i5k4sfy..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }
電鈴事件欄位
欄位 | 說明 | 資料類型 |
---|---|---|
eventSessionId |
Nest Doorbell (電池版) 請使用此事件將這個事件與 CameraClipPreview 特徵的相關 ClipPreview 事件建立關聯。 |
string 例如:「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」 |
eventId |
Nest Doorbell (舊版) 使用 GenerateImage 指令,下載與這個事件相關的相機圖片。 |
string 例如:「FvtxwFMZgjEpB_uEyJ8i5k4sfy...」 |
事件酬載欄位
欄位 | 說明 | 資料類型 |
---|---|---|
eventId |
事件的專屬 ID。 | string 例如:「6af05fd7-c9f5-4387-8942-ec8a6020660a」 |
timestamp |
事件發生的時間。 | string 例如:「2019-01-01T00:00:01Z」 |
resourceUpdate |
詳細列出資源更新相關資訊的物件。 | object |
userId |
代表使用者的不重複且經過模糊處理的 ID。 | string 例如:「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」 |
eventThreadId |
可更新 |
string 例如:「d67cd3f7-86a7-425e-8bb3-462f92ec9f59」 |
eventThreadState |
可更新 |
string 值:「STARTED」、「UPDATED」、「ENDED」 |
resourceGroup |
這個物件代表資源可能具有與此事件類似的更新。事件本身的資源 (來自 resourceUpdate 物件) 一律會顯示在這個物件中。 |
object |
請參閱活動,進一步瞭解 事件類型及其運作方式
錯誤
系統可能會傳回與這個特徵相關的以下錯誤代碼:
錯誤訊息 | 單次點擊收益 | 疑難排解 |
---|---|---|
相機圖片已不再開放下載。 | DEADLINE_EXCEEDED |
事件圖片會在事件發布 30 秒後失效。請務必在到期前下載映像檔。 |
事件 ID 不屬於攝影機。 | FAILED_PRECONDITION |
請使用攝影機事件傳回的正確 eventID 。 |
請參閱 API 錯誤代碼參考資料: API 錯誤代碼的完整清單