Este é o Centro para Desenvolvedores do Google Home, o novo destino para aprender a desenvolver ações de casa inteligente.

Esta página foi traduzida pela API Cloud Translation.

Intents

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

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

Estas são as intents smart home compatíveis:

SYNC
QUERY
EXECUTE
DESCONECT

SINCRONIZAR

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

Quando um usuário configura os dispositivos com o Google Home app (GHA), eles também são autenticados na sua infraestrutura de nuvem. Em seguida, Assistant recebe um token OAuth2. Nesse ponto, Assistant envia uma intent action.devices.SYNC para o fulfillment para recuperar a lista inicial de dispositivos e recursos do usuário da infraestrutura de nuvem.

Esta figura mostra a interação entre a infraestrutura do Google
e a infraestrutura do parceiro. Na infraestrutura do Google, há uma
lista de parceiros disponível para o app cliente do Google Assistente, que é enviada
à infraestrutura do parceiro para concluir a autenticação OAuth. A autenticação
OAuth do parceiro é a visualização da Web de configuração do parceiro, a visualização da Web OAuth,
as configurações e os termos opcionais e os serviços em nuvem do parceiro. A infraestrutura do parceiro
retorna as credenciais OAuth ao app cliente do Google Assistente. Os serviços em nuvem
do parceiro enviam os dispositivos e recursos disponíveis aos serviços do Google Assistente,
que armazenam as informações no gráfico da casa. — Figura 1: interação entre o Google e a infraestrutura do parceiro

Para evitar a desvinculação e a vinculação novamente da conta de um usuário, envie uma solicitação de sincronização para Assistant. Isso envia a intent action.devices.SYNC para o fulfillment para sincronizar a lista de dispositivos e recursos. Consulte Implementar a sincronização de solicitações para mais informações.

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

Durante a configuração do fulfillment local, o plataforma do Google Home verifica a resposta SYNC do fulfillment em nuvem da ação smart home. Para saber mais sobre como modificar a resposta SYNC para oferecer suporte ao fulfillment local, consulte Atualizar a resposta de sincronização no fulfillment na nuvem.

QUERY

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

Quando os usuários consultam o status do dispositivo, para responder a uma pergunta como Ei Google, quais luzes estão acesas na cozinha?, O Assistant envia uma intent action.devices.QUERY para o fulfillment.

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

Para oferecer a melhor experiência do usuário, implemente Report State para informar proativamente o estado atual dos dispositivos de um usuário diretamente para Google Home Graph. Por exemplo, isso permite que Assistant saiba se o usuário acendeu uma luz inteligente com um interruptor físico.

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

EXECUTE

A intent action.devices.EXECUTE é usada para fornecer comandos a serem executados em dispositivos smart home.

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

Diagrama de fluxo de uma intent EXECUTAR — Figura 5: intent EXECUTAR

DESCONECTAR

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

Tipos e características do dispositivo

Fulfillment