Schema dei tratti di rilevamento della presenza di persone per la smart home

action.devices.traits.OccupancySensing - Questa caratteristica appartiene ai dispositivi in grado di rilevare la presenza di persone tramite PIR, ultrasuoni o contatto fisico.

ATTRIBUTI dispositivo

I dispositivi con questo tratto potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Completamento dell'intent.

Attributi Tipo Descrizione
occupancySensorConfiguration Array

Un elenco di oggetti, ciascuno contenente il tipo di sensore e i ritardi e la soglia di eventi associati.
[item, ...] Oggetto

Un tipo di sensore e i ritardi e la soglia di eventi associati, se applicabili.
occupancySensorType String

Obbligatorio.

Valori supportati:

PIR
Il dispositivo supporta il rilevamento della presenza di persone tramite il rilevamento a infrarossi passivi (PIR).
ULTRASONIC
Il dispositivo supporta il rilevamento della presenza di persone tramite rilevamento a ultrasuoni.
PHYSICAL_CONTACT
Il dispositivo supporta la presenza di persone tramite il rilevamento del contatto fisico.
occupiedToUnoccupiedDelaySec Intero

Rappresenta il ritardo, in secondi, prima che il numero di persone segnalato diventi uno stato di non occupato dopo l'ultimo evento rilevato.
unoccupiedToOccupiedDelaySec Intero

Rappresenta il ritardo, in secondi, prima che il numero di persone segnalato diventi occupato dopo l'ultimo evento rilevato. Obbligatorio se hai impostato occupiedToUnoccupiedDelaySec.
unoccupiedToOccupiedEventThreshold Intero

Specifica il numero di eventi di rilevamento che devono verificarsi nel periodo unoccupiedToOccupiedDelaySec prima che il numero di persone segnalato diventi occupato. Obbligatorio se hai impostato unoccupiedToOccupiedDelaySec.

Esempi

Sensore di presenza che supporta il rilevamento PIR e a ultrasuoni.

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

Dispositivo STATES

Le entità con questa trait possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Completamento dell'intent.

Stati Tipo Descrizione
occupancy String

Obbligatorio.

Indica se il dispositivo rileva la presenza di persone.

Valori supportati:

OCCUPIED
Il dispositivo rileva la presenza di persone.
UNOCCUPIED
Il dispositivo non rileva la presenza di persone.
UNKNOWN_OCCUPANCY_STATE
L'attuale stato di occupazione rilevato dal dispositivo è sconosciuto.

Esempi

Il sensore rileva la presenza di persone in ufficio?

{
  "occupancy": "OCCUPIED"
}

COMMANDS dispositivo

Nessuna.

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.