Schema dei tratti di Smart Home EnergyStorage

action.devices.traits.EnergyStorage: questa caratteristica appartiene ai dispositivi che possono immagazzinare energia in una batteria e potenzialmente ricaricarsi o ai dispositivi che possono caricare un altro dispositivo.

ATTRIBUTI dispositivo

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

Attributi Tipo Descrizione
queryOnlyEnergyStorage Valore booleano

Obbligatorio.

True se questo dispositivo supporta solo query sui livelli di energia memorizzati 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 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 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
}

Stati del dispositivo

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

Stati Tipo Descrizione
descriptiveCapacityRemaining String

Obbligatorio.

Una descrizione qualitativa del livello di capacità energetica. Tieni presente che questo vale quando non sono presenti dati numerici sulla capacità. Se sono disponibili anche dati numerici sulla capacità, questi verranno preferiti 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 disponibile sul dispositivo. Ad esempio: Quanti chilometri ha attualmente il mio <dispositivo> o Qual è la percentuale di carica del mio <dispositivo>
[item, ...] Oggetto

Capacità rimanente in coppia 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 alla ricarica completa di <dispositivo>.
[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

Indica se il dispositivo è attualmente collegato. Il dispositivo può essere collegato, 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 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 del dispositivo

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

Avvia comando di ricarica

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

Comando di interruzione della ricarica

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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.

deviceUnplugged: L'utente ha provato a caricare un dispositivo non collegato.