CameraPerson 結構定義

Nest Cam (舊版) Nest Cam Indoor/Outdoor (電池版) Nest Cam (搭配泛光燈) Nest Cam Indoor (有線版) Nest Hub Max Nest Doorbell (舊版) Nest Doorbell (電池版) Nest Doorbell (有線版) 

sdm.devices.traits.CameraPerson

凡是支援人物偵測事件的裝置，都屬於這項特徵。

欄位

這個特徵沒有可用的欄位。

指令

這個特徵沒有可用的指令。

事件

人物

可更新 

攝影機偵測到有人。

這項活動支援可更新的通知。您可以使用後續事件的內容，更新從這個事件建立的現有應用程式通知，但前提是後續事件必須具有相同的 eventThreadId。

訪客偵測事件

酬載

{
  "eventId" : "5ff7c81d-541d-45f7-9fb7-b59acf7088f5",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "cLwcdKVZql7R2OO_5N_AHrDa4G...",
      }
    }
  }
  "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，用於識別單一相關事件工作階段中發生的事件。可能用於合併事件。

您可以使用這個 ID，將此事件與 CameraClipPreview 特徵的相關 ClipPreview 事件建立關聯。

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

搭配 GenerateImage 指令使用，即可下載與此事件相關的攝影機影像。

 string
示例：「cLwcdKVZql7R2OO_5N_AHrDa4G...」

事件酬載欄位

欄位 說明 資料類型
eventId 事件的專屬 ID。 string
示例：「5ff7c81d-541d-45f7-9fb7-b59acf7088f5」
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 錯誤代碼參考資料。