Esquema de características de casa inteligente de energia doméstica
action.devices.traits.EnergyStorage
: essa característica pertence a dispositivos que podem armazenar energia em uma 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 como processar intents SYNC
, consulte
fulfillment de intent.
Atributos | Tipo | Descrição |
---|---|---|
queryOnlyEnergyStorage |
Booleano |
Obrigatório. Verdadeiro se o dispositivo oferecer suporte apenas a consultas sobre os níveis de energia armazenados e, como opção, o estado de carregamento ativo (dependendo 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 informar 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 relatórios do nível de carga atual
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
STATES do dispositivo
Entidades com essa característica podem relatar os estados
a seguir como parte da operação QUERY
. Para saber
mais sobre como processar intents QUERY
, consulte
fulfillment de intent.
Estados | Tipo | Descrição |
---|---|---|
descriptiveCapacityRemaining |
String |
Obrigatório. Descrição qualitativa do nível de capacidade da energia. Observe que isso ocorre quando não há dados de capacidade numérica. Se os dados de capacidade numérica também estiverem disponíveis, eles terão preferência em relação a descrições quando 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 do dispositivo no momento. Por exemplo: Quantos quilômetros meu <device> tem no momento ou Qual é a porcentagem de cobrança do <device>? |
[item, ...] |
Object |
Capacidade restante no par de unidades e valores. |
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é que <device> esteja 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. |
isPluggedIn |
Booleano |
Se o dispositivo está conectado no momento. O dispositivo pode estar conectado, mas não está 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 relatórios do nível de cobrança 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 como processar intents EXECUTE
, consulte
fulfillment de intent.
action.devices.commands.Charge
Iniciar ou parar o carregamento.
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 ou para parar de carregar. |
Exemplos
Iniciar comando de carregamento
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
Parar o comando de carregamento
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
Dispositivo ERRORS
Veja a lista completa de erros e exceções.deviceUnplugged
: o usuário tentou carregar um dispositivo que não está conectado.