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 :
|
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 du filtre calculé
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 :
|
Matières particulaires
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 :
|
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 |
currentSensorState |
String |
Valeur actuelle de l'état descriptif. Établit une correspondance avec une valeur |
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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }