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 dos modos de casa inteligente

action.devices.traits.Modes: essa característica abrange todos os modos disponíveis e as configurações específicas de cada dispositivo.

Essa característica pertence a qualquer dispositivo com um número arbitrário de modos "unidirecionais", em que os modos e as configurações de cada modo são arbitrários e exclusivos para cada dispositivo ou tipo de dispositivo. Cada modo tem várias configurações possíveis, mas apenas uma pode ser selecionada por vez. Uma secadora não pode estar nos modos "delicado", "normal" e "de trabalho pesado" simultaneamente. Uma configuração que só pode ser ativada ou desativada pertence à característica Toggles.

Por exemplo, uma máquina de lavar pode ter configurações de tamanho e temperatura de carregamento. Ambos são modos porque são independentes um do outro, mas cada um pode estar em apenas um estado por vez. O usuário pode definir um modo como a temperatura explicitamente com um comando, como Definir a temperatura da lavadora para o frio.

Alguns modos são "ordenados" e também podem ser ajustados com para cima/baixo, aumentar/diminuir o texto. Por exemplo, o tamanho de carregamento (pequeno, médio, grande) e a temperatura são ordenados claramente (observe que a temperatura não é um termostato real com uma meta numérica, como em outros dispositivos), mas o tipo de carregamento (delicadas, normais, de lã etc.) pode não ser.

Essa característica abrange um ou mais modos individuais que os usuários podem definir. Em geral, esses modos são usados para funcionalidades desvinculadas de outro comportamento do dispositivo. O comportamento vinculado, como ativar ou desativar o próprio dispositivo, precisa usar características mais específicas, por exemplo, a thermostatMode no característica TemperatureSetting.

ATRIBUTOS DO DISPOSITIVO

Dispositivos com essa característica podem relatar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Entrega de intents.

Atributos Tipo Descrição
availableModes Array

Obrigatório.

Lista de modos disponíveis.

[item, ...] Object

Modo disponível.

name String

Obrigatório.

Nome interno do modo, que será usado em comandos e estados. Esse conteúdo não é fácil de usar e será compartilhado em todos os idiomas.

name_values Array

Obrigatório.

Sinônimos do modo em cada idioma compatível.

[item, ...] Object

Sinônimos do modo em um determinado idioma.

name_synonym Array

Obrigatório.

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

[item, ...] String

Nome do sinônimo.

lang String

Obrigatório.

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

settings Array

Obrigatório.

Configurações compatíveis com este modo.

[item, ...] Object

Configuração compatível.

Exige pelo menos dois itens.

setting_name String

Obrigatório.

Nome interno da configuração do modo, que será usado em comandos e estados. Esse conteúdo não é fácil de usar e será compartilhado em todos os idiomas.

setting_values Array

Obrigatório.

Sinônimos da configuração em cada idioma compatível.

[item, ...] Object

Sinônimos da configuração em um determinado idioma.

setting_synonym Array

Obrigatório.

Sinônimos da configuração. A primeira string da lista é usada como o nome canônico do nível nesse idioma.

[item, ...] String

Nome do sinônimo.

lang String

Obrigatório.

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

ordered Booleano

Padrão: false.

Se for definida como verdadeira, a gramática adicional da lógica de aumento/diminuição será aplicada, na ordem (mais alta) da matriz de configurações.

commandOnlyModes Booleano

Padrão: false.

Indica se o dispositivo oferece suporte ao uso da comunicação unidirecional (verdadeira) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou a um estado de relatório para esta característica.

queryOnlyModes Booleano

Padrão: false.

Obrigatório se o dispositivo for compatível com a execução apenas de consulta. Esse atributo indica se o dispositivo só pode ser consultado para informações de estado e não pode ser controlado.

Exemplos

Dispositivo com vários modos e configurações

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "load",
            "size",
            "load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "small",
                "half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "medium",
                "normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "large",
                "full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "temperature",
            "temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "hot",
                "white"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "warm",
                "color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "cold",
                "delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Dispositivo com modos somente de comando

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "light",
            "lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "day",
                "bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "night",
                "dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "reading",
                "ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

ESTADOS DISPOSITIVOS

Dispositivos com essa característica podem relatar os seguintes estados como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Entrega de intents.

Estados Tipo Descrição
currentModeSettings Object

Obrigatório.

Pares de chave-valor com o modo name do dispositivo como chave e o setting_name atual como o valor.

<string> String

Atual: setting_name.

Exemplos

Em que modo o dispositivo está?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

COMANDOS DO DISPOSITIVO

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte Entrega de intents.

action.devices.commands.SetModes

Configurações do modo de atualização.

Parâmetros

Parâmetros Tipo Descrição
updateModeSettings Object

Obrigatório.

Pares de chave-valor com o modo name do dispositivo como chave e o novo setting_name como o valor.

<string> String

Novo setting_name.

Exemplos

Defina para uma carga grande.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Exemplos de declarações

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • definir o aspirador para modo de economia de energia

es-ES

  • pon la lavadora en modo frío

fr-FR

  • atendeu l'aspirateur pt-BR silencieux

ERRORS de dispositivo

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