Esquema de la función de almacenamiento en casa inteligente
action.devices.traits.EnergyStorage
: Esta característica pertenece a los dispositivos que pueden almacenar energía en una batería y posiblemente recargarla, o a los 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 manejar los 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, opcionalmente, el estado de carga activa (según el atributo |
energyStorageDistanceUnitForUX |
String |
(Predeterminado: Se usará en las respuestas para el usuario. Valores admitidos:
|
isRechargeable |
Booleano |
(Predeterminado: Se establece en verdadero si el 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 manejar los 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 siempre que sea posible. Valores admitidos:
|
capacityRemaining |
Matriz |
Matriz de pares de valores y unidades que contienen información sobre la capacidad energética que tiene el dispositivo Por ejemplo: ¿Cuántas millas 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:
|
capacityUntilFull |
Matriz |
Matriz de pares de valores y unidades que contienen 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:
|
isCharging |
Booleano |
Si el dispositivo se está cargando. |
isPluggedIn |
Booleano |
Si el dispositivo está conectado en este momento El dispositivo se puede conectar, 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 del nivel de carga actual
{ "descriptiveCapacityRemaining": "LOW" }
Dispositivo COMMAND
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 manejar 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 y falso para detenerla. |
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á conectado.