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

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

设备命令

无。

设备出错

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