CameraClipPreview 架构

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

sdm.devices.traits.CameraClipPreview

此特征属于支持下载片段预览的任何设备。

字段

此特征没有可用的字段。

命令

没有适用于此特征的命令。

事件

ClipPreview

有视频片段可供预览。

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

此事件支持以下事件：

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

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

ClipPreview 事件

载荷

{
  "eventId" : "63dcb59f-552d-4e63-acb3-4fdc98fcfa93",
  "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 示例：“63dcb59f-552d-4e63-acb3-4fdc98fcfa93”
timestamp	相应事件发生的时间。	string 示例：“2019-01-01T00:00:01Z”
resourceUpdate	一个详细说明资源更新信息的对象。	object
userId	代表用户的唯一模糊处理标识符。	string 示例：“AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
resourceGroup	一个对象，用于指示可能与此活动有类似更新的资源。 事件本身的资源（来自 resourceUpdate 对象）将始终存在于此对象中。	object

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

预览片段

如需预览剪辑，请使用 HTTP 授权标头中的 OAuth 访问令牌对 previewUrl 进行 GET 调用：

预览

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

错误

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