Esquema do traço de detecção de ocupação de casa inteligente

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

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de 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 limite de eventos.
[item, ...] Object

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

Obrigatório.

Os valores suportados são:

PIR
O dispositivo é compatível com a detecção de presença por infravermelho passivo (PIR, na sigla em inglês).
ULTRASONIC
O dispositivo é compatível com a detecção de ocupação por meio do sensor ultrassônico.
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 desocupado 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 um 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 informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de 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 no ambiente.
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

Nenhuma.

ERROS DO Dispositivo

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