Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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.