CameraMotion 結構定義

Nest Cam (舊版) Nest Cam (室內外兩用，電池版) Nest Cam (搭配泛光燈) Nest Cam (室內，有線版) Nest Hub Max Nest Doorbell (舊版) Nest Doorbell (電池版) Nest Doorbell (有線版) 

sdm.devices.traits.CameraMotion

這個特徵屬於任何支援動作偵測事件的裝置。

欄位

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

指令

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

活動

動作

可更新 

攝影機偵測到動作。

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

動作事件

酬載

{
  "eventId" : "dda865a8-5977-4648-9e32-be4efb2e485b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "Enftuo_ZbTspCD_GeEhrf6YOf_...",
      }
    }
  }
  "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 例如：「Enftuo_ZbTspCD_GeEhrf6YOf_...」

事件酬載欄位

欄位	說明	資料類型
eventId	事件的專屬 ID。	string 示例："dda865a8-5977-4648-9e32-be4efb2e485b"
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 錯誤代碼參考資料。