Esquema de atributo de detecção de presença da casa inteligente

action.devices.traits.OccupancySensing: essa característica pertence a dispositivos que podem detectar a presença de pessoas, seja por sensores PIR, ultrassônicos ou 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 processamento 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 e o limite de eventos associados.
[item, ...] Object

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

Obrigatório.

Valores aceitos:

PIR
O dispositivo oferece suporte à detecção de ocupação por infravermelho passivo (PIR).
ULTRASONIC
O dispositivo oferece suporte à detecção de ocupação por detecção por ultrassom.
PHYSICAL_CONTACT
O dispositivo oferece suporte à detecção de contato físico.
occupiedToUnoccupiedDelaySec Número inteiro

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

Representa o tempo de atraso, 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 ocupação compatível com PIR e detecção por ultrassom.

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

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
occupancy String

Obrigatório.

Indica se o dispositivo detecta a ocupação.

Valores aceitos:

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

Exemplos

O sensor detecta a presença de pessoas no escritório?

{
  "occupancy": "OCCUPIED"
}

COMANDOS do dispositivo

Nenhum.

ERROS do dispositivo

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