Schema dei tratti di accumulo di energia per la smart home

action.devices.traits.EnergyStorage: questo tratto appartiene ai dispositivi in grado di immagazzinare energia in una batteria e potenzialmente ricaricarsi oppure a dispositivi in grado di ricaricare un altro dispositivo.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'intent.

Attributi	Tipo	Descrizione
queryOnlyEnergyStorage	Valore booleano	Obbligatorio. True se il dispositivo supporta solo query sui livelli di energia memorizzati e, facoltativamente, sullo stato di ricarica attiva (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	Valore booleano	(Valore predefinito: false) Imposta questo valore su true se il dispositivo è ricaricabile. Questo indica che il dispositivo potrebbe segnalare lo stato capacityUntilFull, isCharging e, facoltativamente, isPluggedIn e può 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 la segnalazione del livello di carica attuale

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

STATES del dispositivo

Le entità con questo tratto possono segnalare quanto segue nell'ambito dell'operazione QUERY. Per ulteriori informazioni scopri di più sulla gestione degli intent QUERY; consulta Completamento dell'intent.

Stati	Tipo	Descrizione
descriptiveCapacityRemaining	String	Obbligatorio. Una descrizione qualitativa del livello di capacità energetica. Nota che si riferisce a quando non sono disponibili dati numerici sulla capacità. Se sono disponibili anche dati numerici sulla capacità, da preferire rispetto a quelli descrittivi, se possibile. Valori supportati: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Array	Array di coppie unità/valore che contengono informazioni sulla capacità energetica attualmente occupata dal dispositivo. Ad esempio: Quanti chilometri ha il mio <device>? attualmente ho o Qual è la percentuale di carica del mio <device>
[item, ...]	Oggetto	Capacità rimanente nella coppia di unità e valore.
rawValue	Intero	Obbligatorio. Il valore della capacità.
unit	String	Obbligatorio. L'unità di capacità. Valori supportati: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Array	array di coppie unità/valore che contengono informazioni sulla capacità fino a quando il dispositivo non è completamente carico. Ad esempio: Quanto tempo manca a <device> sia completamente carica.
[item, ...]	Oggetto	Capacità fino alla ricarica.
rawValue	Intero	Obbligatorio. Il valore della capacità.
unit	String	Obbligatorio. L'unità di capacità. Valori supportati: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Valore booleano	Se il dispositivo è attualmente in carica.
isPluggedIn	Valore booleano	Se il dispositivo è attualmente collegato. Il dispositivo può essere collegato alla corrente, ma non in ricarica attiva.

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 segnalazione del livello di carica attuale

{
  "descriptiveCapacityRemaining": "LOW"
}

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.Charge

Avviare o interrompere la ricarica.

Questo comando richiede i seguenti attributi:

{
  "isRechargeable": true
}

Parametri

Parametri	Tipo	Descrizione
charge	Valore booleano	Obbligatorio. True per avviare la ricarica, false per interrompere la ricarica.

Esempi

Avvia il comando di ricarica

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

Interrompi comando di ricarica

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

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.

deviceUnplugged: l'utente ha tentato di ricaricare un dispositivo che non è collegato alla corrente.