攝影機短片預覽結構定義

Nest Doorbell (電池版) Nest Doorbell (有線版) 

sdm.devices.traits.CameraClipPreview

這個特徵屬於任何支援下載短片預覽的裝置。

欄位

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

指令

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

活動

ClipPreview

短片可供預覽。

短片預覽是 10 格 MP4 格式影片檔案。你可以選擇顯示 mp4 影片檔案，或將其轉碼為其他格式 (例如動畫 GIF)，以便顯示完整的 10 個影格序列。選取剪輯預覽方法時，應考量裝置用戶端功能。

此事件支援下列事件：

類型	元素	說明
活動	CameraMotion 特徵的 Motion 事件	攝影機偵測到動作。
活動	CameraPerson 屬性的 Person 事件	攝影機偵測到有人。
活動	Doorbell Doorbell 特徵的管控事件	已按下門鈴。

使用 eventSessionId 將此事件和相關 previewUrl 與一或多個支援的事件建立關聯。

ClipPreview 事件

酬載

{
  "eventId" : "0efc68d0-c23b-4060-a037-97ef6fd8c45b",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraClipPreview.ClipPreview" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "previewUrl" : "https://previewUrl/..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

ClipPreview 事件欄位

欄位	說明	資料類型
eventSessionId	在相關事件的單一工作階段中發生的事件所獲得的 ID。可用於合併活動。	string 例如：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
previewUrl	預覽影片片段的網址。預設的視訊轉碼器為 H264。	string 示例：「https://previewUrl/...」

事件酬載欄位

欄位	說明	資料類型
eventId	事件的專屬 ID。	string 例如：「0efc68d0-c23b-4060-a037-97ef6fd8c45b」
timestamp	事件發生的時間。	string 例如：「2019-01-01T00:00:01Z」
resourceUpdate	詳細列出資源更新相關資訊的物件。	object
userId	代表使用者的不重複且經過模糊處理的 ID。	string 例如：「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
resourceGroup	這個物件可指出可能與此事件類似的更新資源。事件本身的資源 (來自 resourceUpdate 物件) 一律會顯示在這個物件中。	object

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

預覽短片

如要預覽短片，請使用 HTTP 授權標頭中的 OAuth 存取權權杖，對 previewUrl 發出 GET 呼叫：

預覽

curl -H 'Authorization: Bearer access-token' \
  https://previewUrl/...

錯誤

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