Schéma des caractéristiques de transaction StateState pour les maisons connectées
action.devices.traits.SensorState
: cette caractéristique couvre à la fois la mesure quantitative et l'état qualitatif.
Appareil : ATTRIBUTES
Les appareils associés à 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 page 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 être doté d'une capacité au moins descriptive ou numérique. Les capteurs peuvent également signaler les deux, auquel cas la valeur numérique sera privilégiée. |
[item, ...] |
Objet |
Fonctionnalités de capteurs compatibles. Nécessite au moins un article. |
name |
Chaîne |
Obligatoire. Type de capteur compatible. Consultez le tableau "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 pas de valeur. |
[item, ...] |
Chaîne |
Valeur d'état descriptif acceptée. Nécessite au moins un article. |
numericCapabilities |
Objet |
Description des valeurs numériques possibles que le capteur peut signaler. |
rawValueUnit |
Chaîne |
Obligatoire. Unité numérique acceptée. |
Pour en savoir plus sur les différentes fonctionnalités et différents types de capteurs compatibles avec cette caractéristique, consultez la page Capteurs compatibles.
Exemples
Capteur qui indique une valeur descriptive de l'état.
{ "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 descriptive et numérique d'état.
{ "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 fonctionnalités qui leur sont associées.
Qualité de l'air
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Monoxyde de carbone
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Niveau de fumée
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Nettoyage des filtres
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Fuite d'eau
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Détection de pluie
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Durée de vie du filtre
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Durée de vie du filtre calculé
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Niveau de dioxyde de carbone
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Maturité particulaire
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
composés organiques volatils
Nom | Fonctionnalités de description | Capacités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Appareil : STATES
Les entités présentant 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 page Traitement des intents.
États | Type | Description |
---|---|---|
currentSensorStateData |
Array |
Obligatoire. Liste des états actuels des capteurs. |
[item, ...] |
Objet |
État actuel du capteur. |
name |
Chaîne |
Obligatoire. Nom de l'état du capteur. Correspond à une valeur de |
currentSensorState |
Chaîne |
Valeur actuelle de l'état descriptif. Correspond à une valeur de |
rawValue |
Number |
Valeur actuelle du capteur numérique. |
Pour en savoir plus sur les différentes fonctionnalités et différents types de capteurs compatibles avec cette caractéristique, consultez la page Capteurs compatibles.
Exemples
Capteur qui indique une valeur descriptive de l'état.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Capteur qui indique une valeur d'état numérique.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Capteur qui indique une valeur descriptive et numérique d'état.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
Appareil COMMANDS
Aucune.
NOTIFICATIONS de l'appareil
Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de notification suivante dans le cadre d'un 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 lue à voix haute. |
name |
Chaîne |
Obligatoire. Nom de l'état du capteur. Consultez la liste des types de capteurs compatibles pour les notifications. |
currentSensorState |
Chaîne |
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 compatibles avec chaque type de capteur, consultez la page Capteurs compatibles.
Exemples
Le
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }