CameraClipPreview 架构
Nest Doorbell(电池)
sdm.devices.traits.CameraClipPreview
此 trait 属于任何支持下载剪辑预览的设备。
字段
此特征没有可用字段。
命令
没有适用于此特征的命令。
事件
ClipPreview
有可供预览的视频片段。
剪辑预览是一个 10 帧的 mp4 格式视频文件。您可以选择显示 mp4 视频文件,或将其转码为其他格式(例如 GIF 动画),以便显示完整的 10 帧序列。选择剪辑预览方法时,应考虑设备客户端功能。
以下事件支持此事件:
类型 | 元素 | 说明 |
---|---|---|
事件 | CameraMotion 特征的 Motion 事件 | 摄像头检测到有动静。 |
事件 | CameraPerson 特征的 Person 事件 | 摄像头检测到有人。 |
事件 | DoorbellChime 特征的 Chime 事件 | 有人按了门铃。 |
eventSessionId
将此事件以及相关的 previewUrl
与一个或多个受支持的事件相关联。
ClipPreview 事件
载荷
{ "eventId" : "c026a523-cee9-43e3-b5ef-c225468db861",
"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 示例:“c026a523-cee9-43e3-b5ef-c225468db861” |
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 错误代码的完整列表。