CameraSound 架构

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

sdm.devices.traits.CameraSound

此 trait 属于支持声音检测事件的任何设备。

字段

此 trait 没有可用的字段。

命令

没有适用于此 trait 的命令。

事件

声音

摄像头检测到声音。

声音事件

载荷

{
  "eventId" : "65006b72-f169-4da9-9c18-b8239fe522d1",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.CameraSound.Sound" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "f7tLGzBi2G2kkV77cUg1B0fnuv..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

声音事件字段

字段 说明 数据类型
eventSessionId 为在单个相关事件会话中发生的事件分配的 ID。可用于整合事件。 string
示例:“CjY5Y3VKaTZwR3o4Y19YbTVfMF...”
eventId 与事件相关联的 ID。

将其与 GenerateImage 命令搭配使用,即可下载与此事件相关的相机图片。

string
示例:“f7tLGzBi2G2kkV77cUg1B0fnuv...”

事件载荷字段

字段 说明 数据类型
eventId 事件的唯一标识符。 string
示例:“65006b72-f169-4da9-9c18-b8239fe522d1”
timestamp 事件发生的时间。 string
示例:“2019-01-01T00:00:01Z”
resourceUpdate 详细介绍资源更新相关信息的对象。 object
userId 用于代表用户的唯一且经过混淆处理的标识符。 string
示例:“AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi”
resourceGroup 一个对象,用于指示可能与此事件进行类似更新的资源。事件本身的资源(来自 resourceUpdate 对象)将始终显示在此对象中。 object

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

错误

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

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

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