Esquema de característica de almacenamiento de energía para casas inteligentes

action.devices.traits.EnergyStorage: Esta característica pertenece a dispositivos que pueden almacenar energía en una batería y, potencialmente, recargarse, o bien dispositivos que pueden cargar otro dispositivo.

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
queryOnlyEnergyStorage Booleano

Obligatorio.

Es verdadero si este dispositivo solo admite consultas sobre los niveles de energía almacenados y, de manera opcional, el estado de carga activo (depende del atributo isRechargeable), pero no admite iniciar ni detener la carga.
energyStorageDistanceUnitForUX String

(Predeterminado: "KILOMETERS")

Se usará en las respuestas al usuario.

Valores admitidos:

KILOMETERS
MILES
isRechargeable Booleano

(Predeterminado: false)

Se establece como verdadero si este dispositivo es recargable. Esto indica que el dispositivo puede informar el estado capacityUntilFull, isCharging y, de manera opcional, isPluggedIn, y puede aceptar el comando Charge.

Ejemplos

Dispositivo recargable

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

Dispositivo recargable que muestra el nivel de carga actual en millas

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

Dispositivo no recargable que solo admite el informe del nivel de carga actual

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

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
descriptiveCapacityRemaining String

Obligatorio.

Una descripción cualitativa del nivel de capacidad energética. Ten en cuenta que esto se aplica cuando no hay datos de capacidad numérica. Si también hay datos de capacidad numérica disponibles, se preferirán a los descriptivos siempre que sea posible.

Valores admitidos:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Matriz

Es un array de pares unidad/valor que contiene información sobre la capacidad de energía que tiene el dispositivo actualmente. Por ejemplo: ¿Cuántas millas tiene actualmente mi <device>? o ¿Qué porcentaje de carga tiene mi <device>?
[item, ...] Objeto

Es la capacidad restante en el par unidad y valor.
rawValue Número entero

Obligatorio.

Es el valor de la capacidad.
unit String

Obligatorio.

La unidad de capacidad.

Valores admitidos:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Matriz

Es un array de pares unidad/valor que contienen información sobre la capacidad hasta que el dispositivo se carga por completo. Por ejemplo: ¿Cuánto tiempo falta para que <device> se cargue por completo?
[item, ...] Objeto

Capacidad hasta que se carga.
rawValue Número entero

Obligatorio.

Es el valor de la capacidad.
unit String

Obligatorio.

La unidad de capacidad.

Valores admitidos:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Booleano

Indica si el dispositivo se está cargando.
isPluggedIn Booleano

Indica si el dispositivo está conectado en ese momento. El dispositivo puede estar enchufado, pero no se está cargando de forma activa.

Ejemplos

Dispositivo recargable

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Dispositivo recargable que muestra el nivel de carga actual en millas

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Dispositivo no recargable que solo admite informar el nivel de carga actual

{
  "descriptiveCapacityRemaining": "LOW"
}

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.Charge

Iniciar o detener la carga

Este comando requiere los siguientes atributos: 
{
  "isRechargeable": true
}

Parámetros

Parámetros Tipo Descripción
charge Booleano

Obligatorio.

Es verdadero para iniciar la carga y falso para detenerla.

Ejemplos

Comando para iniciar la carga

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

Comando para detener la carga

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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.

deviceUnplugged: El usuario intentó cargar un dispositivo que no estaba enchufado.