CameraClipPreview 架构

Nest Doorbell（电池版） Nest Doorbell（有线版） 

sdm.devices.traits.CameraClipPreview

此 trait 适用于支持下载剪辑预览的任何设备。

字段

此 trait 没有可用的字段。

命令

没有适用于此 trait 的命令。

事件

ClipPreview

视频剪辑可供预览。

剪辑预览是 mp4 格式的 10 帧视频文件。您可以选择显示 mp4 视频文件，也可以将其转码为其他格式（例如动画 GIF），以显示完整的 10 帧序列。选择剪辑预览方法时，应考虑设备客户端功能。

以下事件支持此事件：

类型	元素	说明
事件	CameraMotion trait 的 Motion 事件	摄像头检测到有动静。
事件	CameraPerson 特征的 Person 事件	摄像头检测到有人。
事件	DoorbellChime trait 的 Chime 事件	有人按门铃了。

使用 eventSessionId 可将此事件及其相关的 previewUrl 与一个或多个受支持的事件相关联。

ClipPreview 事件

载荷

{
  "eventId" : "4fd6f2dd-d7a2-4908-bd82-e38b7016a919",
  "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	事件的唯一标识符。	string 示例：“4fd6f2dd-d7a2-4908-bd82-e38b7016a919”
timestamp	事件发生的时间。	string 示例：“2019-01-01T00:00:01Z”
resourceUpdate	一个详细说明资源更新信息的对象。	object
userId	代表用户的唯一经过混淆处理的标识符。	string 示例：“AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
resourceGroup	一个对象，用于指明可能与此事件具有类似更新的资源。事件本身的资源（来自 resourceUpdate 对象）将始终显示在此对象中。	object

如需详细了解不同类型的事件及其运作方式，请参阅事件。

预览剪辑

如需预览剪辑，请使用 HTTP Authorization 标头中的 OAuth 访问令牌对 previewUrl 发出 GET 调用：

预览

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

错误

如需查看 API 错误代码的完整列表，请参阅 API 错误代码参考。