Esquema de traços de armazenamento de energia de 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 relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos	Tipo	Descrição
queryOnlyEnergyStorage	Booleano	Obrigatório. Verdadeiro se o dispositivo só oferecer suporte a consultas sobre os níveis de energia armazenados e, opcionalmente, o estado de carregamento ativo (dependendo do atributo isRechargeable), mas não oferecer suporte ao início e à interrupção do 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 os estados 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ó permite relatórios do nível de carga atual

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

STATES do dispositivo

Entidades com essa característica podem relatar o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

Estados	Tipo	Descrição
descriptiveCapacityRemaining	String	Obrigatório. Uma descrição qualitativa do nível de capacidade energética. Isso ocorre quando não há dados de capacidade numérica. Se dados de capacidade numérica também estiverem disponíveis, dê preferência a 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 atualmente ou Que porcentagem de cobrança meu <device> têm
[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é <device> está totalmente carregada.
[item, ...]	Object	Capacidade até a carga.
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 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 que só permite gerar relatórios do nível de carga atual

{
  "descriptiveCapacityRemaining": "LOW"
}

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder ao seguinte como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Fulfillment da intent.

action.devices.commands.Charge

Inicie ou pare 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, falso para parar o carregamento.

Exemplos

Comando de iniciar o carregamento

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

Comando de parar o carregamento

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

ERROS no dispositivo

Veja a lista completa erros e exceções.

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