CameraEventImage 架构

Nest Cam(旧版) Nest Hub Max Nest Doorbell(旧版) 

sdm.devices.traits.CameraEventImage

此 trait 属于支持根据事件生成图片的任何设备。

字段

此 trait 没有可用的字段。

命令

GenerateImage

提供用于下载相机图片的网址。

此命令支持以下事件:

类型 元素 说明
事件 CameraMotion 特征的 Motion 事件 摄像头检测到有动静。
事件 CameraPerson trait 的 Person 事件 摄像头检测到有人。
事件 CameraSound trait 的 Sound 事件 摄像头检测到声音。
事件 DoorbellChime trait 的 Chime 事件 有人按门铃了。
在命令请求中使用支持的事件中的 eventId 来接收与该事件相关的相机图片的下载网址。

GenerateImage 请求和响应

请求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "plh0enulqA1vcalHIQdNX3AQoI..."
  }
}

响应

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

GenerateImage 请求字段

字段 说明 数据类型
eventId 要为其请求相关相机图像的事件的 ID。 string
示例:“plh0enulqA1vcalHIQdNX3AQoI...”

GenerateImage 响应字段

字段 说明 数据类型
url 用于下载相机图片的网址。 string
示例:“https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...”
token 下载映像时要在 HTTP Authorization 标头中使用的令牌。 string
示例:“g.0.eventToken”

下载相机图片

使用 HTTP 授权标头中的 token 和基本授权,从 GenerateImage 命令响应对 url 发出 GET 调用,以下载相机图片:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

使用 widthheight 查询参数自定义 下载的图片只需指定其中一个参数。另一个参数会按 自动根据相机的宽高比进行调整。

例如,如果相机的宽高比为 4:3,如需下载分辨率为 480 x 360 的相机图片,请指定宽度或高度:

宽度

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480

高度

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360

下载网址还存在其他限制:

  • 如果网址中同时提供了这两个参数,则系统会使用 widthheight 被忽略。
  • 如果网址中未提供这两个参数,则系统会为 width 选择默认值 480。

请参阅 CameraImage 特征,用于显示图片信息 属性。

错误

系统可能会针对此 trait 返回以下错误代码:

错误消息 RPC 问题排查
相机图片已不再可供下载。 DEADLINE_EXCEEDED 活动图片会在活动发布 30 秒后过期。请务必在图片过期前下载。
事件 ID 不属于相机。 FAILED_PRECONDITION 使用相机事件返回的正确 eventID

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