Schéma des traits de détection d'occupation de la maison connectée

action.devices.traits.OccupancySensing : cette caractéristique appartient aux appareils pouvant détecter une occupation, que ce soit par Capteur infrarouge passif, par ultrasons ou par contact physique.

ATTRIBUTS DES APPAREILS

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 les seuils 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 Chaîne

Obligatoire.

Valeurs acceptées :

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

Représente le délai, en secondes, avant que le nombre de personnes indiqué ne passe à l'état "inoccupé" après le dernier événement détecté.

unoccupiedToOccupiedDelaySec Entier

Représente le délai, en secondes, avant que le nombre de personnes indiqué ne passe à l'état d'occupation 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 indiqué ne passe à l'état "Occupé". Obligatoire si unoccupiedToOccupiedDelaySec est défini.

Exemples

Capteur de présence compatible avec la détection infrarouge et ultrasons.

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

ÉTATS de l'appareil

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 Chaîne

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

COMMANDES D'appareil

Aucune

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.