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