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

action.devices.traits.EnergyStorage: Este rasgo pertenece a dispositivos que pueden almacenar energía en una batería y posiblemente recargarlos, o a dispositivos que pueden cargar otro dispositivo.

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
queryOnlyEnergyStorage	Booleano	Obligatorio. Se aplica si este dispositivo solo admite consultas sobre los niveles de energía almacenados y, de manera opcional, el estado de carga activo (según el atributo isRechargeable), pero no admite el inicio ni la detención de la carga.
energyStorageDistanceUnitForUX	String	(Predeterminado: "KILOMETERS") Se usarán 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, 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 informar el nivel de carga actual

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

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
descriptiveCapacityRemaining	String	Obligatorio. Es una descripción cualitativa del nivel de capacidad energética. Ten en cuenta que esto es para cuando no hay datos de capacidad numérica. Si también hay datos de capacidad numérica disponibles, se preferirán por sobre los descriptivos cuando sea posible. Valores admitidos: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Matriz	Array de pares unidad-valor que contienen información sobre la capacidad energética que tiene el dispositivo actualmente. Por ejemplo: ¿Cuántos kilómetros recorre mi <device>? tienes actualmente o ¿Qué porcentaje de carga tiene mi <device>? tienen
[item, ...]	Objeto	Capacidad restante en el par de unidad y valor.
rawValue	Número entero	Obligatorio. Es el valor de la capacidad.
unit	String	Obligatorio. Es la unidad de capacidad. Valores admitidos: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Matriz	Es un array de pares de unidad/valor que contienen información sobre la capacidad hasta que el dispositivo está completamente cargado. Por ejemplo: Cuánto tiempo queda <device> está completamente cargada.
[item, ...]	Objeto	Capacidad hasta que se complete la carga.
rawValue	Número entero	Obligatorio. Es el valor de la capacidad.
unit	String	Obligatorio. Es la unidad de capacidad. Valores admitidos: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Booleano	Indica si el dispositivo se está cargando en ese momento.
isPluggedIn	Booleano	Indica si el dispositivo está conectado. El dispositivo puede estar enchufado, pero no se está cargando.

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 este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.Charge

Inicia o detén 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; falso para detener la carga.

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 DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.

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