CameraPerson 結構定義

Nest Cam (舊版) Nest Cam (室內外兩用,電池版) Nest Cam Indoor (搭配泛光燈) Nest Cam Indoor Nest DoorbellNest Doorbell

sdm.devices.traits.CameraPerson

這項特性屬於支援人員偵測事件的任何裝置。

欄位

此特徵沒有可用的欄位。

指令

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

活動

使用者

可更新 

攝影機偵測到一個人。

這個事件支援可更新的通知。您可以使用具有相同 eventThreadId 的後續事件內容,更新從此事件建立的現有應用程式通知。

人物活動

酬載

{
  "eventId" : "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "M7S78ZiC4dTyGf_fPHczuRv26r...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

使用者事件欄位

欄位 說明 資料類型
eventSessionId Nest Doorbell (電池版) Nest Doorbell (有線版) 系統針對單一工作階段中發生的事件給予的 ID。可用於合併事件。

請使用這個程式庫將這個事件與 CameraClipPreview 特徵的相關 ClipPreview 事件建立關聯。

string
範例:「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
eventId Nest Cam (舊版) Nest Hub Max Nest Doorbell (舊版) 與事件相關聯的 ID。

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

string
例如:「M7S78ZiC4dTyGf_fPHczuRv26r...」

事件酬載欄位

欄位 說明 資料類型
eventId 事件的專屬 ID。 string
範例:「d582ccc6-0de9-4cf3-a9ed-cc3b39218c97」
timestamp 事件發生的時間。 string
範例:「2019-01-01T00:00:01Z」
resourceUpdate 提供資源更新詳細資訊的物件。 object
userId 代表使用者的不重複 ID (經過模糊處理)。 string
範例:「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
eventThreadId 可更新 事件執行緒的專屬 ID。 string
範例:「d67cd3f7-86a7-425e-8bb3-462f92ec9f59」
eventThreadState 可更新 事件執行緒的狀態。 string
值:「STARTED」、「UPDATED」、「ENDED」
resourceGroup 表示資源可能會與此事件更新類似的資源。事件本身的資源 (來自 resourceUpdate 物件) 一律會出現在這個物件中。 object

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

錯誤

系統可能會根據這項特徵傳回下列錯誤代碼:

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

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