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 錯誤代碼的完整清單