CameraPerson 架构

Nest Cam（旧版） Nest Cam（室外或室内，电池版） Nest Cam（配有泛光灯） Nest Cam（室内，有线版） Nest Hub Max Nest Doorbell（旧版） Nest Doorbell（电池版） Nest Doorbell（有线版） 

sdm.devices.traits.CameraPerson

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

字段

此特征没有可用的字段。

命令

此特征没有可用的命令。

事件

人物

可更新 

摄像头检测到有人。

此事件支持可更新的通知。可以使用具有相同 eventThreadId 的后续事件内容来更新由此事件创建的现有应用通知。

人物事件

载荷

{
  "eventId" : "a83d73ba-0af9-4751-a226-f91e40b3987c",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "MAEiz3D0IPphj1wutVjbi2a72D...",
      }
    }
  }
  "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
示例："MAEiz3D0IPphj1wutVjbi2a72D..."

事件载荷字段

字段 说明 数据类型
eventId 事件的唯一标识符。 string
示例：“a83d73ba-0af9-4751-a226-f91e40b3987c”
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

如需详细了解不同类型的事件及其运作方式，请参阅事件。

错误

可能会返回与此特征相关的以下错误代码：

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

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