CameraClipPreview 結構定義

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

sdm.devices.traits.CameraClipPreview

凡是支援下載影片預覽畫面的裝置，都擁有這項特徵。

欄位

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

指令

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

活動

ClipPreview

短片可以預覽了。

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

下列事件支援這項事件：

類型 元素 說明
活動 CameraMotion 特徵的動作活動 攝影機偵測到動作。
活動 CameraPerson 特徵的人物活動 攝影機偵測到人物。
活動 DoorbellChime 特徵的電鈴活動 有人按了門鈴。
使用 eventSessionId 將這個活動，以及相關的 previewUrl 與一或多個支援的活動建立連結。

ClipPreview 活動

酬載

{
  "eventId" : "5cf0f62d-5a7c-4a7d-8bca-896d38dfeff5",
  "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
示例：「5cf0f62d-5a7c-4a7d-8bca-896d38dfeff5」
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 錯誤代碼參考資料。