Schema delle caratteristiche dell'energia per la 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.

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
queryOnlyEnergyStorage	Booleano	Obbligatorio. True se questo dispositivo supporta solo le query sui livelli di energia memorizzati e, facoltativamente, sullo stato di ricarica attivo (in base all'attributo isRechargeable), ma non supporta l'avvio e l'interruzione della ricarica.
energyStorageDistanceUnitForUX	String	(Valore predefinito: "KILOMETERS") Verrà utilizzato nelle risposte all'utente. Valori supportati: KILOMETERS MILES
isRechargeable	Booleano	(Valore predefinito: false) Imposta questo valore su true se il dispositivo è ricaricabile. Indica che il dispositivo potrebbe segnalare lo stato capacityUntilFull, isCharging e, facoltativamente, isPluggedIn e accettare il comando Charge.

Esempi

Dispositivo ricaricabile

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

Dispositivo ricaricabile che mostra il livello di carica attuale in miglia

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

Dispositivo non ricaricabile che supporta solo i report sul livello di carica attuale

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

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
descriptiveCapacityRemaining	String	Obbligatorio. Una descrizione qualitativa del livello di capacità energetica. Questo vale quando non sono presenti dati numerici sulla capacità. Se sono disponibili anche dati sulla capacità numerica, verrà preferito ai fini della descrizione, quando possibile. Valori supportati: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Matrice	Array di coppie di unità/valore contenenti informazioni sulla capacità energetica attuale del dispositivo. Ad esempio: Quanti chilometri ha attualmente il mio <device> o Che percentuale di carica ha il mio <device>?
[item, ...]	Oggetto	Capacità rimanente in coppia di unità e valori.
rawValue	Intero	Obbligatorio. Il valore della capacità.
unit	String	Obbligatorio. L'unità di capacità. Valori supportati: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Matrice	Array di coppie 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à al termine della ricarica.
rawValue	Intero	Obbligatorio. Il valore della capacità.
unit	String	Obbligatorio. L'unità di capacità. Valori supportati: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Booleano	Se il dispositivo è in carica.
isPluggedIn	Booleano	Indica se il dispositivo è attualmente collegato. Il dispositivo può essere collegato alla corrente, ma non si sta ricaricando attivamente.

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 carica 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 solo la generazione di report sul livello di carica attuale

{
  "descriptiveCapacityRemaining": "LOW"
}

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'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

Comando di avvio della ricarica

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Comando di interruzione ricarica

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.

deviceUnplugged: l'utente ha provato a ricaricare un dispositivo che non è collegato.