Esquema de la función de detección de la ocupación de casas inteligentes

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

ATRIBUTOS DEL DISPOSITIVO

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre el manejo de intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
occupancySensorConfiguration Matriz

Una lista de objetos, cada uno con el tipo de sensor y sus retrasos y umbral de eventos asociados.

[item, ...] Objeto

Un tipo de sensor y sus retrasos y umbral de evento asociados, si corresponde

occupancySensorType String

Obligatorio.

Valores admitidos:

PIR
El dispositivo admite la ocupación mediante sensores infrarrojos pasivos (PIR).
ULTRASONIC
El dispositivo admite la ocupación mediante sensores ultrasónicos.
PHYSICAL_CONTACT
El dispositivo admite la ocupación a través de 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 de 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 los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de 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"
}

Dispositivo COMMANDS

Ninguno

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.