Esquema de característica de ocupación de casa inteligente

action.devices.traits.OccupancySensing: Este rasgo pertenece a dispositivos que pueden detectar ocupación, ya sea a través de sensores PIR, ultrasónicos o de contacto físico.

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
occupancySensorConfiguration Matriz

Una lista de objetos, cada uno de los cuales contiene el tipo de sensor, los retrasos asociados y el umbral de eventos.
[item, ...] Objeto

Un tipo de sensor y sus retrasos asociados y umbral de eventos, si corresponde.
occupancySensorType String

Obligatorio.

Valores admitidos:

PIR
El dispositivo admite la detección de ocupación a través de la detección infrarroja pasiva (PIR).
ULTRASONIC
El dispositivo admite la detección de ocupación a través de detección ultrasónica.
PHYSICAL_CONTACT
El dispositivo admite ocupación mediante la detección de contactos físicos.
occupiedToUnoccupiedDelaySec Número entero

Representa el retraso, en segundos, antes de que la ocupación informada cambie a un estado desocupado después del último evento detectado.
unoccupiedToOccupiedDelaySec Número entero

Representa el retraso, en segundos, antes de que la ocupación informada cambie a un estado ocupado después del último evento detectado. Es obligatoria si se configura occupiedToUnoccupiedDelaySec.
unoccupiedToOccupiedEventThreshold Número entero

Especifica la cantidad de eventos de detección que deben ocurrir en el período unoccupiedToOccupiedDelaySec antes de que la ocupación informada cambie a un estado ocupado. Es obligatorio si se configura unoccupiedToOccupiedDelaySec.

Ejemplos

Sensor de ocupación compatible con PIR y detección ultrasónica.

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

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
occupancy String

Obligatorio.

Indica si el dispositivo detecta ocupación.

Valores admitidos:

OCCUPIED
El dispositivo detecta ocupación.
UNOCCUPIED
El dispositivo no detecta ocupación.
UNKNOWN_OCCUPANCY_STATE
Se desconoce el estado de ocupación actual que detecta el dispositivo.

Ejemplos

¿El sensor detecta ocupación en la oficina?

{
  "occupancy": "OCCUPIED"
}

COMANDOS del dispositivo

Ninguno

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.