CameraPerson 結構定義

Nest Cam (舊版) Nest Cam (室內外兩用,室內,電池版電池專用電池) Nest Cam (搭配泛光燈的 Nest Cam Indoor,搭配泛光燈,電池的電池版) Nest Cam Indoor (有線版,有線版 Nest Cam Indoor (有線版)Nest Cam Indoor (有線版,有線版){/11

sdm.devices.traits.CameraPerson

此特徵適用於所有支援人員偵測事件的裝置。

欄位

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

指令

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

活動

人物

可更新 

攝影機偵測到一個人。

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

人員活動

酬載

{
  "eventId" : "914a826c-8b1f-4ff9-8b53-a2b92a945cd2",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "9Uk0BSbGbYySSeq4b4LOXni1fb...", } } } "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
例如:「9Uk0BSbGbYySSeq4b4LOXni1fb...」

事件酬載欄位

欄位 說明 資料類型
eventId 事件的專屬 ID。 string
例如:「914a826c-8b1f-4ff9-8b53-a2b92a945cd2」
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

如要進一步瞭解各種事件類型及其運作方式,請參閱「事件」。

錯誤

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

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

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