Schéma des traits du capteur de la maison connectée

action.devices.traits.SensorState : cette caractéristique couvre à la fois les mesures quantitatives et l'état qualitatif.

Remarque: Pour trouver d'autres caractéristiques associées aux fonctionnalités de détection, vous pouvez consulter notre documentation sur les caractéristiques de la maison connectée. Si vous ne trouvez pas la fonctionnalité de détection dont vous avez besoin, vous pouvez envoyer une demande de fonctionnalité dans l'outil public Issue Tracker.

Attributs d'appareil

Les appareils dotés de 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 section Traitement des intents.

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

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

Exemples

Capteur indiquant une valeur d'état descriptive.

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

Capteur indiquant une valeur d'état numérique.

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

Capteur indiquant 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 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 calculée du filtre

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

Device 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 la section 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 section Capteurs compatibles pour en savoir plus sur les différents types de capteurs et de fonctionnalités compatibles avec cette caractéristique.

Exemples

Capteur indiquant une valeur d'état descriptive.

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

Capteur indiquant une valeur d'état numérique.

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

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

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

COMMANDS d'appareil

Aucun.

NOTIFICATIONS relatives à l'appareil

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

Champs	Type	Description
SensorState	Objet	Obligatoire. Charge utile de 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 section Capteurs compatibles pour en savoir plus sur les différentes fonctionnalités compatibles avec chaque type de capteur.

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.