Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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.