Schema delle caratteristiche di OccupancySensing per la smart home

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

ATTRIBUTES del dispositivo

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

Attributi Tipo Descrizione
occupancySensorConfiguration Matrice

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

Un tipo di sensore e relativi ritardi e soglia di eventi, 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 attraverso il rilevamento a ultrasuoni.
PHYSICAL_CONTACT
Il dispositivo supporta la presenza di persone attraverso il rilevamento dei contatti fisici.
occupiedToUnoccupiedDelaySec Intero

Rappresenta il ritardo, in secondi, prima che il numero di persone segnalato passi a uno stato di inattività 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 è 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 è 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 questo trait possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta fulfillment 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.

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.