Schema trattino energia smart home
action.devices.traits.EnergyStorage
: questa caratteristica appartiene ai dispositivi in grado di immagazzinare energia in una batteria e potenzialmente ricaricarsi, oppure ai dispositivi in grado di ricaricare un altro dispositivo.
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 |
---|---|---|
queryOnlyEnergyStorage |
Booleano |
Obbligatorio. True se questo dispositivo supporta solo query relative ai livelli di energia memorizzati e, facoltativamente, allo stato di ricarica attiva (in base all'attributo |
energyStorageDistanceUnitForUX |
Stringa |
(Valore predefinito: Verrà utilizzato nelle risposte all'utente. Valori supportati:
|
isRechargeable |
Booleano |
(Valore predefinito: Impostato su vero se questo dispositivo è ricaricabile. Ciò indica che il dispositivo potrebbe segnalare lo stato |
Esempi
Dispositivo ricaricabile
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
Dispositivo ricaricabile che mostra il livello di ricarica attuale in miglia
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
Dispositivo non ricaricabile che supporta soltanto la generazione di report sul livello di addebito attuale
{ "isRechargeable": false, "queryOnlyEnergyStorage": 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 |
---|---|---|
descriptiveCapacityRemaining |
Stringa |
Obbligatorio. Una descrizione qualitativa del livello di capacità energetica. Tieni presente che questo stato è indicato quando non sono disponibili dati di capacità numerici. Se sono disponibili anche dati numerici della capacità, se possibile la preferenza sarà quella descrittiva. Valori supportati:
|
capacityRemaining |
Array |
Array di coppie unità/valore contenenti informazioni sulla capacità energetica di cui dispone attualmente il dispositivo. Ad esempio: Quanti chilometri ha attualmente <device> o Che percentuale di addebiti ha <device>? |
[item, ...] |
Oggetto |
Capacità rimanente nella coppia di unità e valore. |
rawValue |
Intero |
Obbligatorio. Il valore della capacità. |
unit |
Stringa |
Obbligatorio. L'unità di capacità. Valori supportati:
|
capacityUntilFull |
Array |
Array di coppie di unità/valore contenenti informazioni sulla capacità fino a quando il dispositivo non è completamente carico. Ad esempio, quanto tempo manca alla ricarica completa di <device>. |
[item, ...] |
Oggetto |
Capacità fino alla ricarica. |
rawValue |
Intero |
Obbligatorio. Il valore della capacità. |
unit |
Stringa |
Obbligatorio. L'unità di capacità. Valori supportati:
|
isCharging |
Booleano |
Indica se il dispositivo è in carica. |
isPluggedIn |
Booleano |
Indica se il dispositivo è attualmente collegato. Il dispositivo può essere collegato alla corrente, ma non in carica. |
Esempi
Dispositivo ricaricabile
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Dispositivo ricaricabile che mostra il livello di ricarica attuale in miglia
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Dispositivo non ricaricabile che supporta soltanto la generazione di report sul livello di ricarica attuale
{ "descriptiveCapacityRemaining": "LOW" }
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.Charge
Avvia o interrompi la ricarica.
Questo comando richiede i seguenti attributi:{ "isRechargeable": true }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
charge |
Booleano |
Obbligatorio. Vero per avviare la ricarica, falso per interrompere la ricarica. |
Esempi
Avvia il comando di ricarica
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
Comando Interrompi ricarica
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
ERRORI del dispositivo
Consulta l'elenco completo degli errori e delle eccezioni.deviceUnplugged
: l'utente ha provato a ricaricare un dispositivo non collegato alla corrente.