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 isRechargeable), mas não oferece suporte para o início e a interrupção do 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 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 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: CRITICALLY_LOW LOW MEDIUM HIGH FULL
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: 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é 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: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
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.