Esquema de atributo EnergyStorage da casa inteligente

action.devices.traits.EnergyStorage: essa característica pertence a dispositivos que podem armazenar energia em uma bateria e, potencialmente, 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 processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
queryOnlyEnergyStorage Booleano

Obrigatório.

Verdadeiro se o dispositivo só oferece suporte a consultas sobre os níveis de energia armazenados e, opcionalmente, ao estado de carregamento ativo (dependendo do atributo isRechargeable), mas não oferece suporte para iniciar e interromper o carregamento.
energyStorageDistanceUnitForUX String

Padrão: "KILOMETERS".

Será usado nas respostas ao usuário.

Valores aceitos:

KILOMETERS
MILES
isRechargeable Booleano

Padrão: false.

Defina como "true" 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 quilômetros

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

Dispositivo não recarregável que só oferece suporte para 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 operação QUERY. Para saber mais sobre o processamento 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 ocorre quando não há dados de capacidade numérica. Se os dados de capacidade numérica também estiverem disponíveis, eles serão preferidos aos descritivos, quando possível.

Valores aceitos:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Matriz de pares de unidade/valor com informações sobre a capacidade de energia que o dispositivo mantém. Por exemplo: Quantas milhas meu <device> tem no momento ou Qual é a porcentagem de carga do meu <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.

Valores aceitos:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

Matriz de pares de unidade/valor que armazena informações sobre a capacidade até que o dispositivo esteja totalmente carregado. Por exemplo: Quanto tempo até que o <device> esteja totalmente carregado.
[item, ...] Object

Capacidade até a cobrança.
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 à tomada. 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 quilômetros

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Dispositivo não recarregável que só permite gerar relatórios do nível de carga atual

{
  "descriptiveCapacityRemaining": "LOW"
}

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento 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.

True para iniciar o carregamento, false para interromper.

Exemplos

Comando "start charging"

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

Comando "stop charging"

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

ERROS no dispositivo

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

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