CameraClipPreview 結構定義

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

sdm.devices.traits.CameraClipPreview

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

欄位

沒有任何適用於這個特徵的欄位。

指令

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

活動

ClipPreview

短片可供預覽。

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

此事件支援下列事件：

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

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

ClipPreview 事件

酬載

{
  "eventId" : "0c2b2686-da80-42da-be38-8bebb9a9eeea",
  "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 例如：「0c2b2686-da80-42da-be38-8bebb9a9eeea」
timestamp	事件發生的時間。	string 例如：「2019-01-01T00:00:01Z」
resourceUpdate	詳細列出資源更新相關資訊的物件。	object
userId	代表使用者的不重複且經過模糊處理的 ID。	string 例如：「AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi」
resourceGroup	這個物件代表資源可能具有與此事件類似的更新。事件本身的資源 (來自 resourceUpdate 物件) 一律會顯示在這個物件中。	object

如要進一步瞭解不同的事件類型及其運作方式，請參閱事件。

預覽短片

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

預覽

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

錯誤

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