CameraPerson 架构

Nest Cam(旧版) Nest Cam(室外用或室内用,电池版) Nest Cam(带泛光灯) Nest Cam(有线版){/12Nest1}有线Nest CamNest Cam(室外用或室内用,电池版)

sdm.devices.traits.CameraPerson

此特征属于支持人员检测事件的任何设备。

字段

没有可用于此特征的字段。

命令

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

活动

人物

可更新 

摄像头检测到有人。

此事件支持可更新的通知。针对此活动创建的现有应用通知可以使用具有相同 eventThreadId 的后续活动的内容进行更新。

人物事件

载荷

{
  "eventId" : "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraPerson.Person" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "M7S78ZiC4dTyGf_fPHczuRv26r...", } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

用户事件字段

字段 说明 数据类型
eventSessionId Nest Doorbell(电池版) Nest Doorbell(有线版) 为相关事件的单个会话中发生的事件指定的 ID。可用于整合事件。

使用它可将此事件与 CameraClipPreview 特征的相关 ClipPreview 事件相关联。

string
示例:“CjY5Y3VKaTZwR3o4Y19YbTVfMF...”
eventId Nest Cam(旧版) Nest Hub Max Nest Doorbell(旧版) 与事件关联的 ID。

将此命令与 GenerateImage 命令结合使用,可下载与此事件相关的相机图片。

string
示例:“M7S78ZiC4dTyGf_fPHczuRv26r...”

事件载荷字段

字段 说明 数据类型
eventId 事件的唯一标识符。 string
示例:“d582ccc6-0de9-4cf3-a9ed-cc3b39218c97”
timestamp 事件发生的时间。 string
示例:“2019-01-01T00:00:01Z”
resourceUpdate 详细说明资源更新相关信息的对象。 object
userId 代表用户的唯一标识符,进行了混淆处理。 string
示例:“AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
eventThreadId 可更新 事件线程的唯一标识符。 string
示例:“d67cd3f7-86a7-425e-8bb3-462f92ec9f59”
eventThreadState 可更新 事件线程的状态。 string
值:“STARTED”“UPDATED”“ENDED”
resourceGroup 一个对象,用于指明可能对此事件有类似更新的资源。事件本身的资源(来自 resourceUpdate 对象)将始终包含在此对象中。 object

如需详细了解不同类型的事件及其工作原理,请参阅事件

错误

系统可能会返回与此 trait 相关的以下错误代码:

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

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