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

action.devices.traits.OccupancySensing : cette caractéristique appartient aux appareils capables de détecter la présence, que ce soit via un capteur PIR, des ultrasons ou un contact physique.

ATTRIBUTS de l'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, chacun contenant le type de capteur, ses délais et son seuil d'événement associés.
[item, ...] Objet

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

Obligatoire.

Valeurs acceptées :

PIR
L'appareil est compatible avec la détection d'occupation par infrarouge passif (PIR).
ULTRASONIC
L'appareil est compatible avec la détection de l'occupation par ultrasons.
PHYSICAL_CONTACT
L'appareil prend en charge la détection de l'occupation par contact physique.
occupiedToUnoccupiedDelaySec Entier

Représente le délai, en secondes, avant que l'occupation signalée ne passe à l'état "inoccupé" après le dernier événement détecté.
unoccupiedToOccupiedDelaySec Entier

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

Exemples

Capteur d'occupation compatible avec les capteurs PIR 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 avec 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 la présence.

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 présence dans le bureau ?

{
  "occupancy": "OCCUPIED"
}

COMMANDES DE L'APPAREIL

Aucune.

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.