Schéma Trait OccupancySensing Trait

action.devices.traits.OccupancySensing : cette caractéristique est disponible pour les appareils qui peuvent détecter une occupation, que ce soit par PIR, par ultrasons ou par détection physique des contacts.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
occupancySensorConfiguration Array

Une liste d'objets, contenant chacun le type de capteur, les retards associés et le seuil d'événement
[item, ...] Objet

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

Obligatoire.

Valeurs acceptées :

PIR
L'appareil est compatible avec la détection d'occupation par détection infrarouge passive.
ULTRASONIC
L'appareil est compatible avec la détection d'occupation grâce à une détection par ultrasons.
PHYSICAL_CONTACT
L'appareil est compatible avec la détection de contacts physiques.
occupiedToUnoccupiedDelaySec Entier

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

Représente le délai, en secondes, avant que l'occupation indiquée ne passe à un é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 la détection PIR et la détection par ultrasons.

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

Appareil 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 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 l'occupation au bureau ?

{
  "occupancy": "OCCUPIED"
}

Appareil COMMANDS

Aucun.

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.