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 isRechargeable), mas não oferece suporte para iniciar e interromper o carregamento.
energyStorageDistanceUnitForUX	String	Padrão: "KILOMETERS". Será usado nas respostas ao usuário. Os valores suportados são: KILOMETERS MILES
isRechargeable	Booleano	Padrão: false. Defina como verdadeiro se o dispositivo for recarregável. Isso indica que o dispositivo pode relatar o estado capacityUntilFull, isCharging e, opcionalmente, isPluggedIn e 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 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: CRITICALLY_LOW LOW MEDIUM HIGH FULL
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: 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 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: 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 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.