Schéma de trame SensorState pour la maison connectée

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

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
sensorStatesSupported	Array	Obligatoire. Chaque objet représente les capacités d'état des capteurs compatibles avec cet appareil spécifique. Chaque capteur doit au moins avoir une fonction descriptive ou numérique. Les capteurs peuvent également signaler les deux, auquel cas la valeur numérique est préférable.
[item, ...]	Objet	Capteurs compatibles Nécessite au moins un article.
name	String	Obligatoire. Type de capteur compatible. Consultez le tableau sur les capteurs compatibles.
descriptiveCapabilities	Objet	Description des capacités du capteur.
availableStates	Array	Obligatoire. Liste des états disponibles pour l'appareil. La colonne "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 possibles rapportées par le capteur.
rawValueUnit	String	Obligatoire. Unité numérique acceptée.

Consultez la page Capteurs compatibles pour en savoir plus sur les différents et les types de capteurs compatibles avec cette caractéristique.

Exemples

Capteur qui indique la valeur d'état descriptive.

{
  "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 d'état descriptive 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 les capacité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ée

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

Particules en suspension

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

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

Consultez la page Capteurs compatibles pour en savoir plus sur les différents et les types de capteurs compatibles avec cette caractéristique.

Exemples

Capteur qui indique la valeur d'état descriptive.

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

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

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

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

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

COMMANDS d'appareils

Aucun

NOTIFICATIONS relatives à l'appareil

Les appareils présentant cette caractéristique peuvent renvoyer les éléments suivants : charge utile de notification lors du changement d'état de l'appareil. Pour apprendre 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	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

Consultez la page Capteurs compatibles pour en savoir plus sur les différents compatibles avec chaque type de capteur.

Exemples

Le détecte de la fumée.

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

Erreurs d'appareil

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