CameraClipPreview 架构

Nest Doorbell(电池) Nest Doorbell(有线) 

sdm.devices.traits.CameraClipPreview

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

字段

此特征没有可用字段。

命令

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

活动

ClipPreview

有可供预览的视频片段。

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

以下事件支持此事件:

类型 元素 说明
事件 CameraMotion 特征的 Motion 事件 摄像头检测到有动静。
事件 CameraPerson 特征的 Person 事件 摄像头检测到有人。
事件 DoorbellChime 特征的 Chime 事件 有人按了门铃。
使用 eventSessionId 将此事件以及相关的 previewUrl 与一个或多个受支持的事件相关联。

ClipPreview 事件

载荷

{
  "eventId" : "03282331-b02c-4936-9f74-4718f2d7543a",
"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
示例:“03282331-b02c-4936-9f74-4718f2d7543a”
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 错误代码参考