CameraClipPreview 結構定義

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

sdm.devices.traits.CameraClipPreview

這項 trait 屬於任何支援下載短片預覽的裝置。

欄位

此特徵沒有可用的欄位。

指令

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

活動

ClipPreview

可預覽短片。

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

此事件支援下列事件：

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

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

ClipPreview 事件

酬載

{
  "eventId" : "54e55063-25e6-44a5-9aa7-704405bb1c91",
  "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，此 ID 會在單一工作階段中發生相關事件。可用於合併事件。	string 範例：「CjY5Y3VKaTZwR3o4Y19YbTVfMF...」
previewUrl	用於預覽短片的網址。預設影片轉碼器為 H264。	string 例如：「https://previewUrl/...」

事件酬載欄位

欄位	說明	資料類型
eventId	事件的專屬 ID。	string 例如：「54e55063-25e6-44a5-9aa7-704405bb1c91」
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 錯誤代碼參考資料。