Esquema de rasgo de detección de ocupación de casas inteligentes

action.devices.traits.OccupancySensing: Esta característica pertenece a los dispositivos que pueden detectar ocupación, ya sea mediante PIR, ultrasónica o detección de contactos físicos.

Dispositivo ATTRIBUTES

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 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 y sus retrasos y umbral de eventos asociados.
[item, ...] Objeto

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

Obligatorio.

Valores admitidos:

PIR
El dispositivo admite la detección de ocupación mediante la detección infrarroja pasiva (PIR).
ULTRASONIC
El dispositivo admite la detección de ocupación a través de la detección ultrasónica.
PHYSICAL_CONTACT
El dispositivo admite la 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 con 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 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

ERRORS de dispositivos

Consulta la lista completa de errores y excepciones.