Esquema de la función de almacenamiento de energía de casa inteligente

action.devices.traits.EnergyStorage: Esta característica pertenece a los dispositivos que pueden almacenar energía en una batería y a recargarla, o a aquellos 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 el manejo de intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
queryOnlyEnergyStorage	Booleano	Obligatorio. Verdadero si este dispositivo solo admite consultas sobre los niveles de energía almacenados y, de manera opcional, sobre el estado de carga activa (depende del atributo isRechargeable), pero no admite el inicio ni la finalización de la carga.
energyStorageDistanceUnitForUX	String	(Predeterminado: "KILOMETERS") Se usará en las respuestas para el usuario. Valores admitidos: KILOMETERS MILES
isRechargeable	Booleano	(Predeterminado: false) Se establece como verdadero si el dispositivo es recargable. Esto indica que el dispositivo puede informar estados capacityUntilFull, isCharging y, opcionalmente, 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 la generación de informes sobre el nivel de carga actual

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

Dispositivo STATEs

Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
descriptiveCapacityRemaining	String	Obligatorio. Una descripción cualitativa del nivel de capacidad energética. Tenga en cuenta que esto es para cuando no hay datos de capacidad numérica. Si también hay datos de capacidad numérica disponibles, será preferible que sean descriptivos cuando sea posible. Valores admitidos: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Matriz	Es un array de pares de valores/unidades que contienen información sobre la capacidad energética del dispositivo. Por ejemplo: ¿Cuántos kilómetros tiene mi <device> actualmente o qué porcentaje tiene mi <device>?
[item, ...]	Objeto	Capacidad restante en el par de valores y la unidad.
rawValue	Número entero	Obligatorio. El valor de capacidad.
unit	String	Obligatorio. La unidad de capacidad. Valores admitidos: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Matriz	Es un array de pares de valores/unidades que retienen información sobre la capacidad hasta que el dispositivo se carga por completo. Por ejemplo, cuánto tiempo falta para que se complete la carga de <device>.
[item, ...]	Objeto	Capacidad hasta que se cargue.
rawValue	Número entero	Obligatorio. El valor de capacidad.
unit	String	Obligatorio. La unidad de capacidad. Valores admitidos: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Booleano	Si el dispositivo se está cargando
isPluggedIn	Booleano	Si el dispositivo está conectado actualmente El dispositivo puede estar conectado, 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 la generación de informes sobre el nivel de carga actual

{
  "descriptiveCapacityRemaining": "LOW"
}

Dispositivo COMMANDS

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 el manejo de 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. Verdadero para iniciar la carga y falso para detener la carga.

Ejemplos

Iniciar comando de carga

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

Comando para detener la carga

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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.

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