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.

Esta página foi traduzida pela API Cloud Translation.

Intents

As intents de casa inteligente são objetos de mensagens simples que descrevem qual smart home ação realizar, como acender uma luz ou transmitir áudio para um alto-falante.

Todas as intents smart home estão contidas no action.devices e você precisa fornecer um fulfillment para eles. Sempre que O Google Assistant envia uma intent para o fulfillment, o token de acesso OAuth 2 de terceiros é transmitido no cabeçalho "Autorização".

Estas são as intents smart home com suporte:

SYNC
QUERY
EXECUTAR
DESCONECTAR

SINCRONIZAR

A intent action.devices.SYNC é usada para solicitar a lista de smart home dispositivos que o usuário conectou e está disponíveis para uso.

Quando o usuário configura os dispositivos com o Google Home app (GHA), ele também na sua infraestrutura de nuvem. Depois, Assistant recebe um token OAuth2. Neste ponto, Assistant envia uma intent action.devices.SYNC ao seu fulfillment para recuperar a lista inicial de dispositivos e recursos do usuário com a infraestrutura em nuvem.

A figura mostra a interação entre a infraestrutura do Google
e a infraestrutura do parceiro. Na infraestrutura do Google, há um
lista de parceiros disponível para o app cliente do Assistente, que então
para a infraestrutura do parceiro concluir a autenticação OAuth. O OAuth
no lado do parceiro é o WebView de configuração do parceiro, o WebView OAuth,
configurações e termos opcionais
e serviços de nuvem de parceiros. A infraestrutura do parceiro,
Em seguida, ele retorna as credenciais do OAuth para o app cliente do Assistente. O parceiro
serviços em nuvem envia os dispositivos e recursos disponíveis para os serviços do Assistente,
que armazena as informações no Home Graph. — Figura 1: interação entre o Google e o parceiro infraestrutura

Para evitar desvincular e vincular novamente a conta de um usuário, você pode enviar uma sincronização de solicitações para Assistant. Isso envia a intent action.devices.SYNC ao fulfillment para sincronizar a lista de dispositivos e recursos. Consulte Implementar a sincronização de solicitações para saber mais informações imprecisas ou inadequadas.

Diagrama de fluxo de uma intent SYNC — Figura 2: intent SYNC

Durante a configuração do fulfillment local, a A plataforma local verifica a resposta SYNC do smart home Fulfillment da nuvem da Action. Para saber mais sobre como para modificar sua resposta SYNC para oferecer suporte ao fulfillment local, consulte Atualizar a resposta SYNC no fulfillment da nuvem.

CONSULTA

A intent action.devices.QUERY é usada para consultar o estado atual. de smart home dispositivos.

Quando os usuários estão consultando o status do dispositivo, para responder a uma pergunta como Ok Google, quais luzes da cozinha estão acesas?, Assistant envia uma intent action.devices.QUERY ao seu o atendimento do pedido.

Diagrama de fluxo de uma intent QUERY — Figura 3: intent de CONSULTA

Para a melhor experiência do usuário, você deve implementar Estado do relatório para informar proativamente o estado atual dos dispositivos de um usuário diretamente Google Home Graph Por exemplo, isso permite Assistant sabe se o usuário acendeu uma iluminação inteligente com um interruptor físico.

Como informar o estado do dispositivo usando o estado do relatório — Figura 4: informar o estado do dispositivo

EXECUTE

A intent action.devices.EXECUTE é usada para fornecer comandos para execução em dispositivos smart home.

Quando os usuários enviam comandos para dispositivos com Assistant, sua fulfillment recebe uma intent action.devices.EXECUTE para o cumprimento que descreve a ação e os dispositivos usados. Um usuário pode executar uma ação em um dispositivo com um comando, como Ok Google, ligue as luzes da sala de estar.

Diagrama de fluxo de uma intent "EXECUTE" — Figura 5: intent de EXECUÇÃO

DESCONECTAR

A intent action.devices.DISCONNECT é acionada para informar você quando um usuário desvincula a conta do app do Assistant. Depois de receber uma intent action.devices.DISCONNECT, não informe para os dispositivos desse usuário.

Tipos e características do dispositivo

Fulfillment