Esta é a Central do desenvolvedor do Google Home, o novo destino para aprender a desenvolver ações de casa inteligente. Observação:você continuará criando ações no Console do Actions.

Esquema da característica de preenchimento de casa inteligente

action.devices.traits.Fill: esta característica se aplica a dispositivos compatíveis com encher a banheira, como uma banheira.

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de intent.

Atributos Tipo Descrição
availableFillLevels Object

Descreve diferentes níveis de preenchimento do dispositivo.

levels Array

Obrigatório.

Lista de nomes de níveis e sinônimos específicos do idioma.

[item, ...] Object

Nome do nível e sinônimos específicos do idioma.

level_name String

Obrigatório.

Nome interno do nível. Essa opção pode ser difícil de usar e será compartilhada em todos os idiomas.

level_values Array

Obrigatório.

Sinônimos do nível em cada idioma suportado.

[item, ...] Object

Sinônimos do nível em um determinado idioma.

level_synonym Array

Obrigatório.

Sinônimo do nível. A primeira string nessa lista é usada como o nome canônico do nível nesse idioma.

[item, ...] String

Nome de sinônimo.

lang String

Obrigatório.

Código do idioma (ISO 639-1). Veja os idiomas compatíveis.

ordered Booleano

Obrigatório.

Se for verdadeiro, o dispositivo processará gramática adicional para aumentar ou diminuir a lógica, conforme representado pela matriz levels (por exemplo, meio nível).

supportsFillPercent Booleano

Padrão: false.

Se verdadeiro, aceita comandos para ajustar o nível para uma porcentagem.

Exemplos

Dispositivo com recursos básicos de preenchimento ou esvaziamento que não são compatíveis com níveis discretos de preenchimento.

{}

Dispositivo compatível com níveis discretos de preenchimento.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

STATES do dispositivo

As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte fulfillment de intent.

Estados Tipo Descrição
isFilled Booleano

Obrigatório.

Verdadeiro se o dispositivo estiver preenchido em qualquer nível. Falso se o dispositivo estiver completamente drenado.

currentFillLevel String

Obrigatório se o atributo availableFillLevels estiver definido. Indica o level_name atual do atributo availableFillLevels em que o dispositivo está preenchido.

currentFillPercent Número

Obrigatório se o atributo supportsFillPercent estiver definido. Indica a porcentagem atual do nível de preenchimento.

Exemplos

A banheira está cheia?

{
  "isFilled": true
}

A banheira está cheia? (com níveis).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.Fill

Preencha ou esvazie o dispositivo.

Parâmetros

Parâmetros Tipo Descrição
fill Booleano

Obrigatório.

Verdadeiro para preencher, falso para drenar.

fillLevel String

Indica o level_name do atributo availableFillLevels a ser definido. Se não for especificado, preencha o nível padrão.

fillPercent Número

Indica a porcentagem do nível solicitado.

Exemplos

Preencha a banheira.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

Drene a banheira.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Preencha a metade da banheira.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Aumente o nível de preenchimento da banheira em um (necessário que o atributo ordered seja true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

Dispositivo ERRORS

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