攝影機短片預覽結構定義

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

sdm.devices.traits.CameraClipPreview

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

欄位

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

指令

沒有適用於這個特徵的指令。

活動

ClipPreview

短片可供預覽。

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

此事件支援下列事件：

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

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

ClipPreview 事件

酬載

{
  "eventId" : "cb940fc7-9da0-4358-aea2-0e4fca9b1b44",
  "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 示例："cb940fc7-9da0-4358-aea2-0e4fca9b1b44"
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 錯誤代碼參考資料。