DoorbellChime 架构

Nest Doorbell（旧版） Nest Doorbell（电池版） Nest Doorbell（有线版） 

sdm.devices.traits.DoorbellChime

此特征属于支持门铃响铃和相关按压事件的任何设备。

字段

此特征没有可用的字段。

命令

此特征没有可用的命令。

事件

电铃

可更新 

有人按了门铃。

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

电铃事件

载荷

{
  "eventId" : "fb5c9576-873c-4c64-8537-99c31219bf8f",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "YsKSa6B_DyKDCK-yTccczkjva9..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

Chime 活动字段

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

使用此属性将相应事件与 CameraClipPreview 特征相关的 ClipPreview 事件相关联。

 string
示例："CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Doorbell（旧版） 与事件关联的 ID。

将其与 GenerateImage 命令搭配使用，可下载与相应事件相关的摄像头图像。

 string
示例："YsKSa6B_DyKDCK-yTccczkjva9..."

事件载荷字段

字段 说明 数据类型
eventId 事件的唯一标识符。 string
示例：“fb5c9576-873c-4c64-8537-99c31219bf8f”
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 错误代码参考文档。