Esquema de rasgo de EnergyStorage para casas inteligentes
action.devices.traits.EnergyStorage
: Esta característica pertenece a los dispositivos que pueden almacenar energía en una batería y, posiblemente, recargarse, o a los dispositivos que pueden cargar otro dispositivo.
Dispositivo ATTRIBUTES
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 forma opcional, sobre el estado de carga activa (según el atributo |
energyStorageDistanceUnitForUX |
String |
(Predeterminado: Se usará en las respuestas al usuario. Valores admitidos:
|
isRechargeable |
Booleano |
(Predeterminado: Se establece como verdadero si este dispositivo es recargable. Esto indica que el dispositivo puede informar el estado |
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 del 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 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 es para cuando no hay datos de capacidad numérica. Si también hay datos de capacidad numéricos disponibles, se recomienda usarlos en lugar de descriptivos cuando sea posible. Valores admitidos:
|
capacityRemaining |
Matriz |
Arreglo de pares de unidad/valor que contienen información sobre la capacidad energética que tiene el dispositivo actualmente. Por ejemplo: ¿Cuántos kilómetros tiene mi <device> actualmente o Qué porcentaje de carga tiene mi <device>? |
[item, ...] |
Objeto |
Capacidad restante en la unidad y el par de valor. |
rawValue |
Número entero |
Obligatorio. El valor de la capacidad. |
unit |
String |
Obligatorio. La unidad de capacidad. Valores admitidos:
|
capacityUntilFull |
Matriz |
Es el array de pares de unidad/valor que almacenan información sobre la capacidad hasta que el dispositivo está completamente cargado. Por ejemplo: Cuánto tiempo falta para que <device> esté totalmente cargada. |
[item, ...] |
Objeto |
Capacidad hasta que se cargue. |
rawValue |
Número entero |
Obligatorio. El valor de la capacidad. |
unit |
String |
Obligatorio. La unidad de capacidad. Valores admitidos:
|
isCharging |
Booleano |
Indica si el dispositivo se está cargando en ese momento. |
isPluggedIn |
Booleano |
Si el dispositivo está conectado actualmente. El dispositivo está enchufado, pero no se está cargando activamente. |
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
Inicia o detén la carga.
Este comando requiere los siguientes atributos:{ "isRechargeable": true }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
charge |
Booleano |
Obligatorio. El valor es 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 } }
ERRORS de dispositivos
Consulta la lista completa de errores y excepciones.deviceUnplugged
: El usuario intentó cargar un dispositivo que no está enchufado.