Schema della funzionalità di accumulo di 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 a dispositivi in grado di ricaricare un altro dispositivo.

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Completamento dell'intent.

Attributi Tipo Descrizione
queryOnlyEnergyStorage Valore booleano

Obbligatorio.

True se questo dispositivo supporta solo le query sui livelli di energia immagazzinati e, facoltativamente, sullo stato di ricarica attivo (a seconda dell'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 su true se il dispositivo è ricaricabile. Ciò indica che il dispositivo potrebbe segnalare gli stati 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 corrente

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

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli intent.

Stati Tipo Descrizione
descriptiveCapacityRemaining String

Obbligatorio.

Una descrizione qualitativa del livello di capacità energetica. Tieni presente che si tratta di un valore da utilizzare quando non sono disponibili dati numerici sulla capacità. Se sono disponibili anche dati numerici sulla capacità, questi avranno la precedenza sui dati 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 attualmente il mio <device> o Qual è la percentuale di carica del mio <device>
[item, ...] Oggetto

Capacità rimanente in 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 manca alla ricarica completa di <device>.
[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 carica 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 chilometri

{
  "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 corrente

{
  "descriptiveCapacityRemaining": "LOW"
}

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

action.devices.commands.Charge

Avvia o interrompi 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 interromperla.

Esempi

Comando di inizio 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 di errori ed eccezioni.

deviceUnplugged: l'utente ha provato a ricaricare un dispositivo non collegato alla corrente.