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