Schéma du comportement de détection de l'occupation de la maison connectée

action.devices.traits.OccupancySensing : cette caractéristique appartient aux appareils qui peuvent détecter une occupation via la détection de contact physique, par infrarouge ou par ultrasons.

Attributs d'appareil

Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section Traitement des intents.

Attributs Type Description
occupancySensorConfiguration Array

Liste d'objets, contenant chacun le type de capteur, ainsi que les délais et le seuil d'événements associés.

[item, ...] Objet

Un type de capteur, ainsi que les délais et le seuil d'événements associés, le cas échéant

occupancySensorType String

Obligatoire.

Valeurs acceptées :

PIR
L'appareil prend en charge la détection de l'occupation via la détection à infrarouge passif (PIR).
ULTRASONIC
L'appareil détecte l'occupation via la détection par ultrasons.
PHYSICAL_CONTACT
L'appareil détecte l'occupation via la détection des contacts physiques.
occupiedToUnoccupiedDelaySec Entier

Représente le délai, en secondes, avant que l'occupation signalée devienne inoccupée après le dernier événement détecté.

unoccupiedToOccupiedDelaySec Entier

Représente le délai, en secondes, avant que l'occupation signalée devienne "occupée" après le dernier événement détecté. Obligatoire si occupiedToUnoccupiedDelaySec est défini.

unoccupiedToOccupiedEventThreshold Entier

Spécifie le nombre d'événements de détection qui doivent se produire au cours de la période unoccupiedToOccupiedDelaySec avant que le nombre de personnes signalé ne passe à l'état "occupé". Obligatoire si unoccupiedToOccupiedDelaySec est défini.

Exemples

Capteur de présence compatible avec la détection par ultrasons et infrarouges

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

Device STATES

Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États Type Description
occupancy String

Obligatoire.

Indique si l'appareil détecte une occupation.

Valeurs acceptées :

OCCUPIED
L'appareil détecte une occupation.
UNOCCUPIED
L'appareil ne détecte aucune occupation.
UNKNOWN_OCCUPANCY_STATE
L'état d'occupation actuel détecté par l'appareil est inconnu.

Exemples

Le capteur détecte-t-il une occupation au bureau ?

{
  "occupancy": "OCCUPIED"
}

COMMANDS d'appareil

Aucun.

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.