智能家居占用感知特征架构
action.devices.traits.OccupancySensing
- 此特征适用于可通过 PIR、超声波或物理接触感应检测在家/外出情况的设备。
设备特性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
occupancySensorConfiguration |
数组 |
对象的列表,每个对象都包含传感器类型及其关联的延迟和事件阈值。 |
[item, ...] |
对象 |
传感器类型及其关联的延迟和事件阈值(如果适用)。 |
occupancySensorType |
String |
必填。 支持的值:
|
occupiedToUnoccupiedDelaySec |
整数 |
表示从上次检测到的事件发生后,所报告的在家/外出状态更改为“无人”状态之前的延迟时间(以秒为单位)。 |
unoccupiedToOccupiedDelaySec |
整数 |
表示在上次检测到事件后,报告的在家/外出状态变为“在家/外出状态”之前的延迟时间(以秒为单位)。如果设置了 |
unoccupiedToOccupiedEventThreshold |
整数 |
指定在报告的在家/外出状态变为“在家/外出状态”之前,必须在 |
示例
支持 PIR 和超声波感应的占位传感器。
{ "occupancySensorConfiguration": [ { "occupancySensorType": "PIR", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 }, { "occupancySensorType": "ULTRASONIC", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 } ] }
设备状态
具有此特征的实体可能会在 QUERY
操作过程中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
occupancy |
String |
必填。 指示设备是否感知到在家/外出情况。 支持的值:
|
示例
传感器是否检测到办公室里是否有人在家?
{ "occupancy": "OCCUPIED" }
设备命令
无。