CameraSound 架构

Nest Cam（旧版） Nest Hub Max Nest Doorbell（旧版） 

sdm.devices.traits.CameraSound

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

字段

此特征没有可用字段。

命令

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

活动

声音

摄像头检测到声音。

声音事件

载荷

{
  "eventId" : "16f43b7a-0a44-47b8-9a3e-c529cc404855",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraSound.Sound" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "S9Li5CSC2X_GSbgmNkUBGDfD8i..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

声音事件字段

字段	说明	数据类型
eventSessionId	为在相关事件的单个会话过程中发生的事件指定的 ID。可用于整合事件。	string 示例：“CjY5Y3VKaTZwR3o4Y19YbTVfMF...”
eventId	与事件相关联的 ID。 您可以将此命令与 GenerateImage 命令搭配使用，以下载与此事件相关的相机图像。	string 示例：“S9Li5CSC2X_GSbgmNkUBGDfD8i...”

事件载荷字段

字段	说明	数据类型
eventId	事件的唯一标识符。	string 示例：“16f43b7a-0a44-47b8-9a3e-c529cc404855”
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 错误代码参考。