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 isRechargeable), ma non supporta l'avvio e l'interruzione della ricarica.
energyStorageDistanceUnitForUX	Stringa	(Valore predefinito: "KILOMETERS") Verrà utilizzato nelle risposte all'utente. Valori supportati: KILOMETERS MILES
isRechargeable	Booleano	(Valore predefinito: false) Impostato su vero se questo dispositivo è ricaricabile. Ciò 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 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: CRITICALLY_LOW LOW MEDIUM HIGH FULL
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: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
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: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
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.