Esquema de atributos para armazenamento de energia de casas inteligentes
action.devices.traits.EnergyStorage
: essa característica pertence a dispositivos que podem armazenar energia na bateria e possivelmente recarregar, ou dispositivos que podem carregar outro dispositivo.
ATRIBUTOS do dispositivo
Dispositivos com essa característica podem informar os seguintes
atributos como parte da operação SYNC
. Para saber
mais sobre o gerenciamento de intents SYNC
, consulte
fulfillment de intents.
Atributos | Tipo | Descrição |
---|---|---|
queryOnlyEnergyStorage |
Booleano |
Obrigatório. "True", se o dispositivo só oferece suporte a consultas sobre os níveis de energia armazenados e, opcionalmente, o estado de carregamento ativo (depende do atributo |
energyStorageDistanceUnitForUX |
String |
Padrão: Será usado nas respostas ao usuário. Os valores suportados são:
|
isRechargeable |
Booleano |
Padrão: Defina como verdadeiro se o dispositivo for recarregável. Isso indica que o dispositivo pode relatar o estado |
Exemplos
Dispositivo recarregável
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
Dispositivo recarregável que mostra o nível de carga atual em milhas
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
Dispositivo não recarregável compatível apenas com o nível de carga atual
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
STATES do dispositivo
Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY
. Para saber
mais sobre o gerenciamento de intents QUERY
, consulte
fulfillment de intents.
Estados | Tipo | Descrição |
---|---|---|
descriptiveCapacityRemaining |
String |
Obrigatório. Uma descrição qualitativa do nível de capacidade de energia. Isso vale para quando não há dados de capacidade numérica. Se dados de capacidade numérica também estiverem disponíveis, será preferível usar dados em vez de descritivos, se possível. Os valores suportados são:
|
capacityRemaining |
Array |
Matriz de pares de unidade/valor que contêm informações sobre a capacidade de energia atual do dispositivo. Por exemplo: Quantos quilômetros meu <device> tem no momento ou Qual porcentagem de carga meu <device> tem? |
[item, ...] |
Object |
Capacidade restante no par de unidade e valor. |
rawValue |
Número inteiro |
Obrigatório. O valor da capacidade. |
unit |
String |
Obrigatório. A unidade de capacidade. Os valores suportados são:
|
capacityUntilFull |
Array |
Matriz de pares de unidade/valor que contêm informações sobre a capacidade até que o dispositivo esteja totalmente carregado. Por exemplo: quanto tempo até o <device> estar totalmente carregado. |
[item, ...] |
Object |
Capacidade até a carga completa. |
rawValue |
Número inteiro |
Obrigatório. O valor da capacidade. |
unit |
String |
Obrigatório. A unidade de capacidade. Os valores suportados são:
|
isCharging |
Booleano |
Se o dispositivo está carregando no momento. |
isPluggedIn |
Booleano |
Se o dispositivo está conectado no momento. O dispositivo pode estar conectado, mas não estar carregando ativamente. |
Exemplos
Dispositivo recarregável
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Dispositivo recarregável que mostra o nível de carga atual em milhas
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Dispositivo não recarregável compatível apenas com o nível de carga atual
{ "descriptiveCapacityRemaining": "LOW" }
Comandos do dispositivo
Dispositivos com essa característica podem responder aos seguintes
comandos como parte da operação EXECUTE
. Para saber
mais sobre o gerenciamento de intents EXECUTE
, consulte
fulfillment de intents.
action.devices.commands.Charge
Começar ou parar de carregar.
Esse comando requer os seguintes atributos:{ "isRechargeable": true }
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
charge |
Booleano |
Obrigatório. Verdadeiro para começar a carregar, falso para interromper o carregamento. |
Exemplos
Comando para começar a carregar
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
Comando para parar de carregar
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
ERROS DO Dispositivo
Veja a lista completa de erros e exceções.deviceUnplugged
: o usuário tentou carregar um dispositivo que não está conectado.