攝影機短片預覽結構定義

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

sdm.devices.traits.CameraClipPreview

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

欄位

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

指令

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

活動

ClipPreview

可預覽短片。

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

這個事件適用於下列事件：

類型	元素	說明
活動	CameraMotion 特徵的 Motion 事件	攝影機偵測到動作。
活動	CameraPerson 屬性的「Person」事件	攝影機偵測到有人。
活動	DoorbellChime 特徵的 Chime 事件	有人按門鈴。

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

ClipPreview 事件

酬載

{
  "eventId" : "cac055e6-c8df-471f-94ff-6cbfd6c7e969",
  "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 範例："cac055e6-c8df-471f-94ff-6cbfd6c7e969"
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 錯誤代碼參考資料。