智能家居 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
}
}