Schema tratto sensore stato smart home
action.devices.traits.SensorState
: questa caratteristica è valida sia per la misurazione quantitativa sia per lo stato qualitativo.
ATTRIBUTE del dispositivo
I dispositivi con questa caratteristica potrebbero segnalare i seguenti
attributi come parte dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta Soddisfazione degli intent.
Attributi | Tipo | Descrizione |
---|---|---|
sensorStatesSupported |
Array |
Obbligatorio. Ogni oggetto rappresenta le funzionalità di 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 verrà preferito il valore numerico. |
[item, ...] |
Oggetto |
Funzionalità dei sensori supportate. Richiede almeno 1 articolo. |
name |
Stringa |
Obbligatorio. Tipo di sensore supportato. Consulta la tabella Sensori supportati. |
descriptiveCapabilities |
Oggetto |
Una descrizione delle funzionalità del sensore. |
availableStates |
Array |
Obbligatorio. Elenco degli stati disponibili per il dispositivo. Lo stato "sconosciuto" è supportato implicitamente quando il sensore non restituisce un valore. |
[item, ...] |
Stringa |
Valore di stato descrittivo supportato. Richiede almeno 1 articolo. |
numericCapabilities |
Oggetto |
Descrive i possibili valori numerici che il sensore può segnalare. |
rawValueUnit |
Stringa |
Obbligatorio. Unità numerica supportata. |
Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questa caratteristica.
Esempi
Sensore che segnala un valore descrittivo.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Sensore che segnala un valore numerico di stato.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Sensore che segnala un valore 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à associate.
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 supportato. |
Perdita d'acqua
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Non supportato. |
Rilevamento della pioggia
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Non supportato. |
Durata del filtro
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Valori supportati:
|
Valori supportati:
|
Durata del filtro calcolato
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportato. | Valori supportati:
|
Livello di anidride carbonica
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportato. | Valori supportati:
|
Particolato
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportato. | Valori supportati:
|
Composti organici volatili
Nome | Funzionalità descrittive | Funzionalità numeriche |
---|---|---|
Valori supportati:
|
Non supportato. | Valori supportati:
|
STATEs dispositivo
I dispositivi con questa caratteristica potrebbero segnalare i seguenti
stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta Soddisfazione degli intent.
Stati | Tipo | Descrizione |
---|---|---|
currentSensorStateData |
Array |
Obbligatorio. Elenco degli stati dei sensori correnti. |
[item, ...] |
Oggetto |
Stato attuale del sensore. |
name |
Stringa |
Obbligatorio. Nome dello stato del sensore. Corrisponde a un valore da |
currentSensorState |
Stringa |
Valore attuale dello stato descrittivo. Corrisponde a un valore da |
rawValue |
Number |
Valore numerico del sensore attuale. |
Consulta la sezione Sensori supportati per ulteriori dettagli sulle diverse funzionalità e sui tipi di sensori supportati da questa caratteristica.
Esempi
Sensore che segnala un valore descrittivo.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Sensore che segnala un valore numerico di stato.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Sensore che segnala un valore descrittivo e numerico.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
comandi del dispositivo
Nessuno.
NOTIFICHE DEL DISPOSITIVO
Nell'ambito di una modifica dello stato del dispositivo, i dispositivi con questa caratteristica potrebbero restituire il seguente payload di notifica. Per scoprire di più sull'implementazione delle notifiche, consulta Notifiche per le azioni relative alla smart home.
Campi | Tipo | Descrizione |
---|---|---|
SensorState |
Oggetto |
Obbligatorio. Payload della notifica. |
priority |
Intero |
Obbligatorio. Rappresenta il livello di notifica. Il valore attualmente supportato è 0, il che indica che la notifica deve essere pronunciata ad alta voce. |
name |
Stringa |
Obbligatorio. Nome dello stato del sensore. Visualizza l'elenco dei tipi di sensori supportati per le notifiche. |
currentSensorState |
Stringa |
Obbligatorio. Valore attuale dello stato descrittivo. Visualizza 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
Vedi Sensori supportati per ulteriori dettagli sulle diverse funzionalità supportate da ogni tipo di sensore.
Esempi
Il
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }