智能家居 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 日检测到小丽。
{
"ObjectDetection": {
"objects": {
"named": [
"Alice"
]
},
"priority": 0,
"detectionTimestamp": 946684800000
}
}