Schema del Trait di rilevamento della presenza di persone per la smart home

action.devices.traits.OccupancySensing: questo tratto appartiene ai dispositivi in grado di rilevare la presenza di persone tramite il rilevamento PIR, a ultrasuoni o dei contatti fisici.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri 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 la soglia di eventi e i ritardi associati.
[item, ...] Oggetto

Un tipo di sensore e le relative soglie di eventi e ritardi associati, se applicabile.
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 il rilevamento a ultrasuoni.
PHYSICAL_CONTACT
Il dispositivo supporta la presenza di persone tramite il rilevamento dei contatti fisici.
occupiedToUnoccupiedDelaySec Intero

Rappresenta il ritardo in secondi prima che il numero di persone segnalato passi a uno stato vuoto dopo l'ultimo evento rilevato.
unoccupiedToOccupiedDelaySec Intero

Rappresenta il ritardo in secondi prima che il numero di persone segnalato passi a uno stato di occupato dopo l'ultimo evento rilevato. Obbligatorio se è impostato occupiedToUnoccupiedDelaySec.
unoccupiedToOccupiedEventThreshold Intero

Specifica il numero di eventi di rilevamento che devono verificarsi nel periodo unoccupiedToOccupiedDelaySec prima che il numero di persone segnalato passi in stato occupato. Obbligatorio se è 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
    }
  ]
}

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri 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 presenza di persone rilevato dal dispositivo è sconosciuto.

Esempi

Il sensore rileva la presenza di persone in ufficio?

{
  "occupancy": "OCCUPIED"
}

COMANDI dispositivo

Nessuno.

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.