Esquema del atributo de detección de ocupación de la casa inteligente

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

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 cómo controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
occupancySensorConfiguration Matriz

Es una lista de objetos, cada uno de los cuales contiene el tipo de sensor y sus retrasos y umbrales 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 de infrarrojo pasivo (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 a través de la detección de contacto físico.
occupiedToUnoccupiedDelaySec Número entero

Representa el retraso en el tiempo, en segundos, antes de que la ocupación informada cambie a un estado de no ocupado 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
    }
  ]
}

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar 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 del dispositivo

Consulta la lista completa de errores y excepciones.