智能家居占用感知特征架构

action.devices.traits.OccupancySensing - 此特征适用于可通过 PIR、超声波或物理接触感应检测在家/外出情况的设备。

设备特性

具有此特征的设备可能会在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
occupancySensorConfiguration	数组	对象的列表，每个对象都包含传感器类型及其关联的延迟和事件阈值。
[item, ...]	对象	传感器类型及其关联的延迟和事件阈值（如果适用）。
occupancySensorType	String	必填。 支持的值： PIR 设备支持通过被动红外 (PIR) 感应来感知在家/外出情况。 ULTRASONIC 设备支持通过超声波感应来感知在家/外出情况。 PHYSICAL_CONTACT 设备通过身体接触感知来支持在家/外出检测。
occupiedToUnoccupiedDelaySec	整数	表示从上次检测到的事件发生后，所报告的在家/外出状态更改为“无人”状态之前的延迟时间（以秒为单位）。
unoccupiedToOccupiedDelaySec	整数	表示在上次检测到事件后，报告的在家/外出状态变为“在家/外出状态”之前的延迟时间（以秒为单位）。如果设置了 occupiedToUnoccupiedDelaySec，则此字段为必填字段。
unoccupiedToOccupiedEventThreshold	整数	指定在报告的在家/外出状态变为“在家/外出状态”之前，必须在 unoccupiedToOccupiedDelaySec 时间段内发生的检测事件数量。如果设置了 unoccupiedToOccupiedDelaySec，则为必需。

示例

支持 PIR 和超声波感应的占位传感器。

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

设备状态

具有此特征的实体可能会在 QUERY 操作过程中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅 intent 执行方式。

州	类型	说明
occupancy	String	必填。 指示设备是否感知到在家/外出情况。 支持的值： OCCUPIED 设备检测到在家/外出情况。 UNOCCUPIED 设备未检测到在家/外出情况。 UNKNOWN_OCCUPANCY_STATE 设备检测到的当前在家/外出状态未知。

示例

传感器是否检测到办公室里是否有人在家？

{
  "occupancy": "OCCUPIED"
}

设备命令

无。

设备 ERRORS

查看错误和异常的完整列表。