智能家居 ObjectDetection 特征架构

action.devices.traits.ObjectDetection - 此特征属于可检测对象或人物并向用户发送通知的设备。默认情况下,所有 ObjectDetection 通知都会在门铃响铃后,在智能显示屏和智能音箱上通过 Google 助理播报。

设备属性

无。

设备状态

无。

设备命令

无。

设备通知

具有此特征的设备可能会在设备状态变化时返回以下通知载荷。如需详细了解如何实现通知,请参阅智能家居 Action 通知

字段 类型 说明
ObjectDetection 对象

必填。

通知负载。

priority 整数

必填。

表示通知级别。当前支持的值为 0,表示应大声读出通知。

detectionTimestamp 整数

必填。

检测到对象的时间戳(以毫秒为单位)。

objects 对象

必填。

按类别检测到的对象的集合。

named 数组

由用户识别且带有标签的对象列表。

[item, ...] String

对象标签。

至少需要 1 个项目。

familiar 整数

用户识别的、无标签的对象数量。

unfamiliar 整数

设备检测到的用户可能无法识别的对象数量。

unclassified 整数

检测到设备无法分类的对象数量。

示例

2000 年 1 月 1 日检测到两个未知对象。

{
  "ObjectDetection": {
    "objects": {
      "unclassified": 2
    },
    "priority": 0,
    "detectionTimestamp": 946684800000
  }
}

2000 年 1 月 1 日检测到你认识的人。

{
  "ObjectDetection": {
    "objects": {
      "familiar": 1
    },
    "priority": 0,
    "detectionTimestamp": 946684800000
  }
}

于 2000 年 1 月 1 日检测到 Alice。

{
  "ObjectDetection": {
    "objects": {
      "named": [
        "Alice"
      ]
    },
    "priority": 0,
    "detectionTimestamp": 946684800000
  }
}

设备错误

查看错误和异常的完整列表。