Esquema do traç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 sensor de contato físico.

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos Tipo Descrição
occupancySensorConfiguration Array

Uma lista de objetos, cada um contendo o tipo de sensor e os atrasos e limites de evento associados.

[item, ...] Object

Um tipo de sensor e os atrasos e limites de eventos associados, se aplicável.

occupancySensorType String

Obrigatório.

Valores compatíveis:

PIR
O dispositivo oferece suporte à detecção de presença por detecção de infravermelho passivo (PIR, na sigla em inglês).
ULTRASONIC
O dispositivo oferece suporte à detecção de presença por sensor ultrassônico.
PHYSICAL_CONTACT
O dispositivo oferece suporte à presença por meio da detecção de contatos físicos.
occupiedToUnoccupiedDelaySec Número inteiro

Representa o tempo de atraso, em segundos, antes que a ocupação informada mude para um estado desocupada após o último evento detectado.

unoccupiedToOccupiedDelaySec Número inteiro

Representa o tempo de espera, em segundos, antes que a ocupação informada mude para um estado "ocupado" 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 unoccupiedToOccupiedDelaySec antes que a ocupação informada mude para um estado ocupado. Obrigatório se unoccupiedToOccupiedDelaySec estiver definido.

Exemplos

Sensor de presença compatível com PIR e sensor ultrassônico.

{
  "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 o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

Estados Tipo Descrição
occupancy String

Obrigatório.

Indica se o dispositivo detecta presença.

Valores compatíveis:

OCCUPIED
O dispositivo detecta 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 a presença no escritório?

{
  "occupancy": "OCCUPIED"
}

COMANDOS DO dispositivo

Nenhum.

ERROS no dispositivo

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