Schéma des caractéristiques de transaction StateState pour les maisons connectées

action.devices.traits.SensorState : cette caractéristique couvre à la fois la mesure quantitative et l'état qualitatif.

Appareil : ATTRIBUTES

Les appareils associés à 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 page Traitement des intents.

Attributs	Type	Description
sensorStatesSupported	Array	Obligatoire. Chaque objet représente les fonctionnalités d'état des capteurs compatibles avec cet appareil. Chaque capteur doit être doté d'une capacité au moins descriptive ou numérique. Les capteurs peuvent également signaler les deux, auquel cas la valeur numérique sera privilégiée.
[item, ...]	Objet	Fonctionnalités de capteurs compatibles. Nécessite au moins un article.
name	Chaîne	Obligatoire. Type de capteur compatible. Consultez le tableau "Capteurs compatibles".
descriptiveCapabilities	Objet	Description des fonctionnalités du capteur.
availableStates	Array	Obligatoire. Liste des états disponibles pour l'appareil. L'état "inconnu" est implicitement accepté lorsque le capteur ne renvoie pas de valeur.
[item, ...]	Chaîne	Valeur d'état descriptif acceptée. Nécessite au moins un article.
numericCapabilities	Objet	Description des valeurs numériques possibles que le capteur peut signaler.
rawValueUnit	Chaîne	Obligatoire. Unité numérique acceptée.

Pour en savoir plus sur les différentes fonctionnalités et différents types de capteurs compatibles avec cette caractéristique, consultez la page Capteurs compatibles.

Exemples

Capteur qui indique une valeur descriptive de l'état.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Capteur qui indique une valeur d'état numérique.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Capteur qui indique une valeur descriptive et numérique d'état.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

Capteurs compatibles

Les tableaux suivants répertorient les types de capteurs compatibles et les fonctionnalités qui leur sont associées.

Qualité de l'air

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : AirQuality	Valeurs acceptées : healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	Valeurs acceptées : AQI

Monoxyde de carbone

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : CarbonMonoxideLevel	Valeurs acceptées : carbon monoxide detected high no carbon monoxide detected unknown	Valeurs acceptées : PARTS_PER_MILLION

Niveau de fumée

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : SmokeLevel	Valeurs acceptées : smoke detected high no smoke detected unknown	Valeurs acceptées : PARTS_PER_MILLION

Nettoyage des filtres

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : FilterCleanliness	Valeurs acceptées : clean dirty needs replacement unknown	Non compatible.

Fuite d'eau

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : WaterLeak	Valeurs acceptées : leak no leak unknown	Non compatible.

Détection de pluie

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : RainDetection	Valeurs acceptées : rain detected no rain detected unknown	Non compatible.

Durée de vie du filtre

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : FilterLifeTime	Valeurs acceptées : new good replace soon replace now unknown	Valeurs acceptées : PERCENTAGE

Durée de vie du filtre calculé

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Non compatible.	Valeurs acceptées : PERCENTAGE

Niveau de dioxyde de carbone

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : CarbonDioxideLevel	Non compatible.	Valeurs acceptées : PARTS_PER_MILLION

Maturité particulaire

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : PM2.5 PM10	Non compatible.	Valeurs acceptées : MICROGRAMS_PER_CUBIC_METER

composés organiques volatils

Nom	Fonctionnalités de description	Capacités numériques
Valeurs acceptées : VolatileOrganicCompounds	Non compatible.	Valeurs acceptées : PARTS_PER_MILLION

Appareil : STATES

Les entités présentant 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 page Traitement des intents.

États	Type	Description
currentSensorStateData	Array	Obligatoire. Liste des états actuels des capteurs.
[item, ...]	Objet	État actuel du capteur.
name	Chaîne	Obligatoire. Nom de l'état du capteur. Correspond à une valeur de sensorStatesSupported.
currentSensorState	Chaîne	Valeur actuelle de l'état descriptif. Correspond à une valeur de sensorStatesSupported.
rawValue	Number	Valeur actuelle du capteur numérique.

Pour en savoir plus sur les différentes fonctionnalités et différents types de capteurs compatibles avec cette caractéristique, consultez la page Capteurs compatibles.

Exemples

Capteur qui indique une valeur descriptive de l'état.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Capteur qui indique une valeur d'état numérique.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Capteur qui indique une valeur descriptive et numérique d'état.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

Appareil COMMANDS

Aucune.

NOTIFICATIONS de l'appareil

Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de notification suivante dans le cadre d'un changement d'état d'un appareil. Pour en savoir plus sur l'implémentation des notifications, consultez Notifications pour les actions de maison connectée.

Champs	Type	Description
SensorState	Objet	Obligatoire. Charge utile de la notification.
priority	Entier	Obligatoire. Représente le niveau de notification. La valeur actuellement acceptée est 0, ce qui indique que la notification doit être lue à voix haute.
name	Chaîne	Obligatoire. Nom de l'état du capteur. Consultez la liste des types de capteurs compatibles pour les notifications.
currentSensorState	Chaîne	Obligatoire. Valeur actuelle de l'état descriptif. Consultez la liste des types de capteurs compatibles pour les notifications.

La charge utile de la notification peut contenir les types de capteurs suivants:

• AirQuality
• CarbonMonoxideLevel
• SmokeLevel
• FilterCleanliness
• WaterLeak
• RainDetection
• FilterLifeTime

Pour en savoir plus sur les différentes fonctionnalités compatibles avec chaque type de capteur, consultez la page Capteurs compatibles.

Exemples

Le détecte de la fumée.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.