Esquema de rasgos de detección de ocupación de casa inteligente

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. Si quieres obtener más información para controlar 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 umbrales de eventos asociados, 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 mediante 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 que admite 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. Si quieres obtener más información para controlar 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"
}

COMMANDS del dispositivo

Ningún contenido de este tipo

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.