Esquema da característica de detecção de ocupação de casa inteligente

action.devices.traits.OccupancySensing: essa característica pertence a dispositivos que podem detectar presença, seja por PIR, ultrassônico ou detecção de contato físico.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os atributos a seguir como parte da operação SYNC. Para saber mais sobre como gerenciar intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
occupancySensorConfiguration Array

Uma lista de objetos, cada um contendo o tipo de sensor e os atrasos associados e o limite de eventos.
[item, ...] Object

Um tipo de sensor e os atrasos e limite de eventos associados, se aplicável.
occupancySensorType String

Obrigatório.

Os valores suportados são:

PIR
O dispositivo oferece suporte à detecção de presença por infravermelho passivo (PIR, na sigla em inglês).
ULTRASONIC
O dispositivo oferece suporte à detecção de presença por meio da detecção ultrassônica.
PHYSICAL_CONTACT
O dispositivo é compatível com a presença por meio da detecção de contato físico.
occupiedToUnoccupiedDelaySec Número inteiro

Representa o tempo de atraso, em segundos, antes de a ocupação informada mudar para um estado desocupada após o último evento detectado.
unoccupiedToOccupiedDelaySec Número inteiro

Representa o tempo de atraso, em segundos, antes de a ocupação informada mudar para um estado de ocupação após o último evento detectado. Obrigatório se occupiedToUnoccupiedDelaySec estiver definido.
unoccupiedToOccupiedEventThreshold Número inteiro

Especifica o número de eventos de detecção que precisam ocorrer no período de unoccupiedToOccupiedDelaySec antes que a ocupação informada mude para o estado de ocupação. Obrigatório se unoccupiedToOccupiedDelaySec estiver definido.

Exemplos

Sensor de ocupação com suporte para PIR e detecção ultrassônica.

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

STATES do dispositivo

Entidades com essa característica podem relatar os estados a seguir como parte da operação QUERY. Para saber mais sobre como gerenciar intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
occupancy String

Obrigatório.

Indica se o dispositivo detecta presença.

Os valores suportados são:

OCCUPIED
O dispositivo detectou presença.
UNOCCUPIED
O dispositivo não detectou presença.
UNKNOWN_OCCUPANCY_STATE
O estado de ocupação atual detectado pelo dispositivo é desconhecido.

Exemplos

O sensor detecta presença no escritório?

{
  "occupancy": "OCCUPIED"
}

COMANDOS do dispositivo

Nenhum.

ERROS DO DISPOSITIVO

Veja a lista completa de erros e exceções.