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" : "1049fe69-8e1d-4381-ad42-c7f32a90d1af",
  "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 示例：“1049fe69-8e1d-4381-ad42-c7f32a90d1af”
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 错误代码的完整列表。