智能家居 OccupancySensing trait 架构

action.devices.traits.OccupancySensing - 此 trait 适用于可检测有人在家的设备，无论是通过 PIR、超声波还是物理接触感知。

设备属性

具有此 trait 的设备可能会在 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
    }
  ]
}

设备状态

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

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

示例

传感器能否检测到办公室内的在家/外出情况？

{
  "occupancy": "OCCUPIED"
}

设备命令

无。

设备错误

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