Schema della caratteristica di rilevamento della presenza in smart home

action.devices.traits.OccupancySensing: questa caratteristica appartiene ai dispositivi che possono rilevare la presenza di persone tramite sensori PIR, a ultrasuoni o di contatto fisico.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Attributi Tipo Descrizione
occupancySensorConfiguration Array

Un elenco di oggetti, ciascuno contenente il tipo di sensore e i relativi ritardi e soglie di evento associati.
[item, ...] Oggetto

Un tipo di sensore e i relativi ritardi e soglie di evento 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 tramite rilevamento a ultrasuoni.
PHYSICAL_CONTACT
Il dispositivo supporta il rilevamento della presenza tramite il rilevamento del contatto fisico.
occupiedToUnoccupiedDelaySec Intero

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

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

Specifica il numero di eventi di rilevamento che devono verificarsi nel periodo unoccupiedToOccupiedDelaySec prima che il numero di persone registrato passi a uno stato occupato. Obbligatorio se unoccupiedToOccupiedDelaySec è impostato.

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
    }
  ]
}

STATI del dispositivo

Le entità con questo attributo possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli 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
Lo stato attuale della presenza rilevato dal dispositivo è sconosciuto.

Esempi

Il sensore rileva la presenza di persone nell'ufficio?

{
  "occupancy": "OCCUPIED"
}

COMANDI del dispositivo

Nessuno.

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.