Esquema de características de armazenamento de energia da casa inteligente

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

Os dispositivos com essa característica podem informar os seguintes atributos como parte da SYNC operação. Para saber mais sobre como processar SYNC intents, consulte Processamento de intents.

Atributos Tipo Descrição
queryOnlyEnergyStorage Booleano

Obrigatório.

True se esse dispositivo só aceitar consultas sobre os níveis de energia armazenada e, opcionalmente, o estado de carregamento ativo (dependente do atributo isRechargeable), mas não aceitar iniciar e interromper o carregamento.
energyStorageDistanceUnitForUX String

Padrão: "KILOMETERS".

Será usado em respostas ao usuário.

Valores aceitos:

KILOMETERS
MILES
isRechargeable Booleano

Padrão: false.

Defina como verdadeiro se o dispositivo for recarregável. Isso indica que o dispositivo pode informar o estado capacityUntilFull, isCharging e, opcionalmente, isPluggedIn, e pode aceitar o comando Charge.

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 que só aceita informar o nível de carga atual

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

ESTADOS do dispositivo

As entidades com essa característica podem informar os seguintes estados como parte da QUERY operação. Para saber mais sobre como processar QUERY intents, consulte Processamento de intents.

Estados Tipo Descrição
descriptiveCapacityRemaining String

Obrigatório.

Uma descrição qualitativa do nível de capacidade de energia. Observação: isso é para quando não há dados numéricos de capacidade. Se os dados numéricos de capacidade também estiverem disponíveis, eles serão preferidos em relação aos descritivos quando possível.

Valores aceitos:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Matriz de pares de unidade/valor que contêm informações sobre a capacidade de energia que o dispositivo tem no momento. Por exemplo: Quantas milhas meu <device> tem no momento ou Qual a porcentagem de carga do meu <device>
[item, ...] Object

Capacidade restante em par de unidade e valor.
rawValue Número inteiro

Obrigatório.

O valor da capacidade.
unit String

Obrigatório.

A unidade de capacidade.

Valores aceitos:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
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 falta para o <device> estar totalmente carregado.
[item, ...] Object

Capacidade até o carregamento.
rawValue Número inteiro

Obrigatório.

O valor da capacidade.
unit String

Obrigatório.

A unidade de capacidade.

Valores aceitos:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
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 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 que só aceita informar o nível de carga atual

{
  "descriptiveCapacityRemaining": "LOW"
}

COMANDOS do dispositivo

Os dispositivos com essa característica podem responder aos seguintes comandos como parte da EXECUTE operação. Para saber mais sobre como processar EXECUTE intents, consulte Processamento de intents.

action.devices.commands.Charge

Iniciar ou interromper o carregamento.

Esse comando exige os seguintes atributos: 
{
  "isRechargeable": true
}

Parâmetros

Parâmetros Tipo Descrição
charge Booleano

Obrigatório.

True para iniciar o carregamento, false para interromper.

Exemplos

Comando de início do carregamento

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

Comando de interrupção do carregamento

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

ERROS do dispositivo

Consulte a lista completa de erros e exceções.

deviceUnplugged: o usuário tentou carregar um dispositivo que não está conectado.