CameraClipPreview 結構定義

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

sdm.devices.traits.CameraClipPreview

凡是支援下載短片預覽畫面的裝置，都屬於這項特徵。

欄位

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

指令

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

事件

ClipPreview

可預覽短片。

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

下列事件支援這項事件：

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

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

ClipPreview 事件

酬載

{
  "eventId" : "1bb063ae-09d3-4fb3-b7a3-6795e5e18d47",
  "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 示例：「1bb063ae-09d3-4fb3-b7a3-6795e5e18d47」
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 錯誤代碼參考資料。