Schema dei tratti dello stato del sensore per la smart home
action.devices.traits.SensorState
: questa caratteristica riguarda sia la misurazione quantitativa che lo stato qualitativo.
ATTRIBUTES del dispositivo
I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta fulfillment dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
sensorStatesSupported |
Matrice |
Obbligatorio. Ogni oggetto rappresenta le funzionalità dello stato del sensore supportate da questo dispositivo specifico. Ogni sensore deve avere almeno una capacità descrittiva o numerica. I sensori possono anche segnalare entrambi, nel qual caso il valore numerico verrà preferito. |
[item, ...] |
Oggetto |
Capacità dei sensori supportate. Richiede almeno 1 elemento. |
name |
String |
Obbligatorio. Tipo di sensore supportato. Consulta la tabella Sensori supportati. |
descriptiveCapabilities |
Oggetto |
Una descrizione delle funzionalità del sensore. |
availableStates |
Matrice |
Obbligatorio. Elenco degli stati disponibili per il dispositivo. Lo stato "sconosciuto" è implicitamente supportato quando il sensore non restituisce un valore. |
[item, ...] |
String |
Valore dello stato descrittivo supportato. Richiede almeno 1 elemento. |
numericCapabilities |
Oggetto |
Descrive i possibili valori numerici che il sensore può segnalare. |
rawValueUnit |
String |
Obbligatorio. Unità numerica supportata. |
Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questo trait.
Esempi
Dispositivo del sensore che riporta un valore descrittivo dello stato.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Dispositivo sensore che segnala un valore di stato numerico.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Dispositivo sensore che segnala un valore di stato descrittivo e numerico.
{ "sensorStatesSupported": [ { "name": "SmokeLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" }, "descriptiveCapabilities": { "availableStates": [ "smoke detected", "high", "no smoke detected" ] } } ] }
Sensori supportati
Le seguenti tabelle elencano i tipi di sensori supportati e le relative funzionalità.
Qualità dell'aria
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Valori supportati:
|
Monossido di carbonio
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Valori supportati:
|
Livello di fumo
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Valori supportati:
|
Pulizia del filtro
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Non supportati. |
Perdita d'acqua
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Non supportati. |
Rilevamento della pioggia
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Non supportati. |
Durata filtro
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Valori supportati:
|
Durata del filtro calcolata
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportati. | Valori supportati:
|
Livello di anidride carbonica
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportati. | Valori supportati:
|
Particolato
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportati. | Valori supportati:
|
Sostanze organiche volatili
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportati. | Valori supportati:
|
Dispositivo STATES
Le entità con questo trait possono segnalare i seguenti
stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta fulfillment dell'intent.
Stati | Tipo | Descrizione |
---|---|---|
currentSensorStateData |
Matrice |
Obbligatorio. Elenco degli stati attuali del sensore. |
[item, ...] |
Oggetto |
Stato attuale del sensore. |
name |
String |
Obbligatorio. Nome dello stato del sensore. Corrisponde a un valore di |
currentSensorState |
String |
Valore dello stato descrittivo corrente. Corrisponde a un valore di |
rawValue |
Number |
Valore numerico attuale del sensore. |
Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questo trait.
Esempi
Dispositivo del sensore che riporta un valore descrittivo dello stato.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Dispositivo sensore che segnala un valore di stato numerico.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Dispositivo sensore che segnala un valore di stato descrittivo e numerico.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
COMMANDS dispositivo
Nessuna.
NOTIFICHE DEL dispositivo
I dispositivi con questo trait possono restituire il seguente payload di notifica nell'ambito di una modifica dello stato del dispositivo. Per scoprire di più sull'implementazione delle notifiche, consulta Notifiche per le azioni per la smart home.
Campi | Tipo | Descrizione |
---|---|---|
SensorState |
Oggetto |
Obbligatorio. Payload delle notifiche. |
priority |
Intero |
Obbligatorio. Rappresenta il livello di notifica. Il valore attualmente supportato è 0, che indica che la notifica deve essere pronunciata ad alta voce. |
name |
String |
Obbligatorio. Nome dello stato del sensore. Consulta l'elenco dei tipi di sensori supportati per le notifiche. |
currentSensorState |
String |
Obbligatorio. Valore dello stato descrittivo corrente. Consulta l'elenco dei tipi di sensori supportati per le notifiche. |
Il payload delle notifiche può contenere i seguenti tipi di sensori:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità supportate da ciascun tipo di sensore.
Esempi
Il dispositivo
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }