智能家居在家/外出感知功能架构

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"
}

设备命令

无。

设备错误

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