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.
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 :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Monoxyde de carbone
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Niveau de fumée
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Propreté du filtre
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Fuite d'eau
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Détection de la pluie
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Durée de vie du filtre
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Durée de vie calculée du filtre
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Niveau de dioxyde de carbone
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Particules en suspension
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Composants organiques volatils
Nom | Capacités descriptives | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
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 |
currentSensorState |
String |
Valeur actuelle de l'état descriptif. Correspond à une valeur de |
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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }