CameraClipPreview 結構定義
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 錯誤代碼參考資料。