Schéma de trait SensorState pour la maison connectée
action.devices.traits.SensorState
: cette caractéristique couvre à la fois la mesure quantitative et l'état qualitatif.
ATTRIBUTS de l'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 prises en charge par cet appareil spécifique. Chaque capteur doit disposer d'au moins une fonctionnalité 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 des capteurs compatibles. Vous devez ajouter au moins un élément. |
name |
String |
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, ...] |
String |
Valeur d'état descriptive acceptée. Vous devez ajouter au moins un élément. |
numericCapabilities |
Objet |
Décrit les valeurs numériques possibles que le capteur peut signaler. |
rawValueUnit |
String |
Obligatoire. Unité numérique acceptée. |
Pour en savoir plus sur les différentes fonctionnalités et les différents types de capteurs compatibles avec cette caractéristique, consultez la section Capteurs compatibles.
Exemples
Appareil de capteur qui indique une valeur d'état descriptive.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Appareil de capteur qui indique une valeur d'état numérique.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Appareil de 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 fonctionnalités associées.
Qualité de l'air
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Monoxyde de carbone
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Niveau de fumée
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Propreté du filtre
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Fuite d'eau
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Détection de la pluie
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Non compatible. |
Durée de vie du filtre
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Valeurs acceptées :
|
Valeurs acceptées :
|
Durée de vie calculée du filtre
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Niveau de dioxyde de carbone
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Particules en suspension
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
Composants organiques volatils
Nom | Fonctionnalités descriptives | Fonctionnalités numériques |
---|---|---|
Valeurs acceptées :
|
Non compatible. | Valeurs acceptées :
|
ÉTATS DE L'APPAREIL
Les entités avec 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 d'état descriptive actuelle. Correspond à une valeur de |
rawValue |
Number |
Valeur numérique actuelle du capteur. |
alarmState |
String |
État de l'alarme correspondant à la lecture actuelle du capteur. Une pré-alarme ou une alarme peut se déclencher lorsque les mesures des capteurs approchent et atteignent des niveaux dangereux. Valeurs acceptées :
|
alarmSilenceState |
String |
Indique l'état de la mise sous silence de l'alarme du capteur, y compris si la mise sous silence d'une alarme active est actuellement autorisée. Cet état peut être fourni lorsqu'un état d'alarme ou de pré-alarme est actif. Valeurs acceptées :
|
Pour en savoir plus sur les différentes fonctionnalités et les différents types de capteurs compatibles avec cette caractéristique, consultez la section Capteurs compatibles.
Exemples
Appareil de capteur qui indique une valeur d'état descriptive.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Appareil de capteur qui indique une valeur d'état numérique.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Appareil de capteur qui indique une valeur d'état descriptive et numérique.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
Appareil de capteur qui indique une valeur d'état descriptive et numérique et indique qu'une alarme est active.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200, "alarmState": "ALARM", "alarmSilenceState": "DISALLOWED" } ] }
COMMANDES DE L'APPAREIL
Aucune.
Notifications de l'appareil
Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de notification suivante lors d'un changement d'état de l'appareil. Pour en savoir plus sur l'implémentation des notifications, consultez la section 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 d'état descriptive actuelle. 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 section Capteurs compatibles.
Exemples
Le
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }