Schema delle caratteristiche di riempimento della smart home
action.devices.traits.Fill
: questa caratteristica si applica ai dispositivi che supportano il riempimento, come la vasca da bagno.
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 |
---|---|---|
availableFillLevels |
Oggetto |
Descrive i diversi livelli di riempimento del dispositivo. |
levels |
Array |
Obbligatorio. Elenco di nomi di livelli e sinonimi specifici per la lingua. |
[item, ...] |
Oggetto |
Nome del livello e i suoi sinonimi specifici per la lingua. |
level_name |
Stringa |
Obbligatorio. Nome interno del livello. Questa funzionalità non è facile da usare e verrà condivisa in tutte le lingue. |
level_values |
Array |
Obbligatorio. Sinonimi del livello in ogni lingua supportata. |
[item, ...] |
Oggetto |
Sinonimi del livello in una determinata lingua. |
level_synonym |
Array |
Obbligatorio. Sinonimo di livello. La prima stringa dell'elenco viene utilizzata come nome canonico del livello in quella lingua. |
[item, ...] |
Stringa |
Nome sinonimo. |
lang |
Stringa |
Obbligatorio. Codice lingua (ISO 639-1). Scopri le lingue supportate. |
ordered |
Booleano |
Obbligatorio. Se true, il dispositivo gestisce una grammatica aggiuntiva per aumentare o diminuire la logica, come rappresentato dall'array |
supportsFillPercent |
Booleano |
(Valore predefinito: Se true, accetta i comandi per regolare il livello su una percentuale. |
Esempi
Dispositivo con funzionalità di riempimento o svuotamento di base che non supportano livelli di riempimento discreti.
{}
Dispositivo che supporta livelli di riempimento discreti.
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": true } }
STATEs dispositivo
Le entità con questa caratteristica possono 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 |
---|---|---|
isFilled |
Booleano |
Obbligatorio. True se il dispositivo è riempito a qualsiasi livello. False se il dispositivo è completamente svuotato. |
currentFillLevel |
Stringa |
Obbligatorio se è impostato l'attributo |
currentFillPercent |
Number |
Obbligatorio se è impostato l'attributo |
Esempi
La vasca da bagno è piena?
{ "isFilled": true }
La vasca da bagno è piena? (con i livelli).
{ "isFilled": true, "currentFillLevel": "half_level" }
comandi del dispositivo
I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta Soddisfazione degli intent.
action.devices.commands.Fill
Riempi o svuota il dispositivo.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
fill |
Booleano |
Obbligatorio. True per riempire, falso per svuotare. |
fillLevel |
Stringa |
Indica il |
fillPercent |
Number |
Indica la percentuale del livello richiesto. |
Esempi
Riempi la vasca da bagno.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
Svuota la vasca da bagno.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Riempi la vasca da bagno a metà.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
Aumenta di uno il livello di riempimento della vasca (è necessario che l'attributo ordered
sia true
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }