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

action.devices.traits.OccupancySensing : cette caractéristique appartient aux appareils capables de détecter une présence, que ce soit à l'aide d'une fonction infrarouge, d'ultrasons ou de la détection des contacts physiques.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
occupancySensorConfiguration Array

Liste d'objets, chacun contenant 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 permet de détecter l'occupation grâce à la détection infrarouge passive (PIR).
ULTRASONIC
L'appareil détecte l'occupation grâce à la détection par ultrasons.
PHYSICAL_CONTACT
L'appareil prend en charge l'occupation grâce à 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 à un é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 signalé passe à l'état "Occupé". Obligatoire si unoccupiedToOccupiedDelaySec est défini.

Exemples

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

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

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre 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 l'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 dans le bureau ?

{
  "occupancy": "OCCUPIED"
}

COMMANDS d'appareils

Aucun

Erreurs d'appareil

Voir la liste complète les erreurs et les exceptions.