Schéma du traît de capteurs d'état de la maison connectée

action.devices.traits.SensorState : cette caractéristique concerne les mesures quantitatives et l'état qualitatif.

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
sensorStatesSupported	Array	Obligatoire. Chaque objet représente les fonctionnalités d'état des capteurs compatibles avec cet appareil. Chaque capteur doit disposer d'au moins une capacité descriptive ou numérique. Les capteurs peuvent également indiquer les deux, auquel cas la valeur numérique est privilégiée.
[item, ...]	Objet	Fonctionnalités de capteurs compatibles. Nécessite au moins un article.
name	String	Obligatoire. Type de capteur compatible. Consultez le tableau des 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 pris en charge lorsque le capteur ne renvoie pas de valeur.
[item, ...]	String	Valeur d'état descriptif acceptée. Nécessite au moins un article.
numericCapabilities	Objet	Décrit les valeurs numériques que le capteur peut signaler.
rawValueUnit	String	Obligatoire. Unité numérique acceptée.

Pour en savoir plus sur les fonctionnalités et les types de capteurs pris en charge par cette caractéristique, consultez la section Capteurs compatibles.

Exemples

Appareil capteur indiquant une valeur d'état descriptive.

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

Appareil capteur affichant une valeur d'état numérique.

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

Capteur dont la valeur de l'état est descriptif et numérique.

{
  "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 leurs fonctionnalités associées.

Qualité de l'air

Nom	Capacités descriptives	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	Capacités descriptives	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	Capacités descriptives	Capacités numériques
Valeurs acceptées : SmokeLevel	Valeurs acceptées : smoke detected high no smoke detected unknown	Valeurs acceptées : PARTS_PER_MILLION

Propreté du filtre

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

Fuite d'eau

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

Détection de la pluie

Nom	Capacités descriptives	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	Capacités descriptives	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	Capacités descriptives	Capacités numériques
Valeurs acceptées : PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Non compatible.	Valeurs acceptées : PERCENTAGE

Niveau de dioxyde de carbone

Nom	Capacités descriptives	Capacités numériques
Valeurs acceptées : CarbonDioxideLevel	Non compatible.	Valeurs acceptées : PARTS_PER_MILLION

Matières particulaires

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

Composants organiques volatils

Nom	Capacités descriptives	Capacités numériques
Valeurs acceptées : VolatileOrganicCompounds	Non compatible.	Valeurs acceptées : PARTS_PER_MILLION

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
currentSensorStateData	Array	Obligatoire. Liste des états actuels des capteurs.
[item, ...]	Objet	État actuel du capteur.
name	String	Obligatoire. Nom de l'état du capteur. Établit une correspondance avec une valeur sensorStatesSupported.
currentSensorState	String	Valeur actuelle de l'état descriptif. Établit une correspondance avec une valeur sensorStatesSupported.
rawValue	Number	Valeur actuelle du capteur numérique.

Pour en savoir plus sur les fonctionnalités et les types de capteurs pris en charge par cette caractéristique, consultez la section Capteurs compatibles.

Exemples

Appareil capteur indiquant une valeur d'état descriptive.

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

Appareil capteur affichant une valeur d'état numérique.

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

Capteur dont la valeur de l'état est descriptif et numérique.

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

Appareil COMMANDS

Aucun.

NOTIFICATIONS D'APPAREIL

Les appareils présentant cette caractéristique peuvent renvoyer la charge utile de notification suivante en cas de 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 prononcée à voix haute.
name	String	Obligatoire. Nom de l'état du capteur. Consultez la liste des types de capteurs compatibles pour les notifications.
currentSensorState	String	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 proposées par 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 sur l'appareil

Consultez la liste complète des erreurs et exceptions.