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.

Atividade

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

As intents de casa inteligente são objetos de mensagens simples que descrevem o quê smart home Action to perform such as turn on a light or cast audio to a speaker.

Todas as intents smart home estão contidas no namespace action.devices, e é necessário fornecer fulfillment para elas. Sempre Google Assistant sends an intent to fulfillment, a user's third-party OAuth 2 access token is passed in the Authorization header.

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

SINCRONIZAR

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

Quando um usuário configura o dispositivo com o Google Home app (GHA) , they also get authenticated to your cloud infrastructure. Then, Assistant receives an OAuth2 token. At this point, Assistant sends a action.devices.SYNC intent to your fulfillment to retrieve the initial list of user devices and capabilities from your cloud infrastructure.

Ela mostra a interação entre a infraestrutura do Google e a do parceiro. Da infraestrutura do Google, há uma lista de parceiros disponíveis para o app cliente do Assistente que flui até a infraestrutura do parceiro para concluir a autenticação OAuth. A autenticação OAuth no lado do parceiro é a WebView de configuração do parceiro, o WebView do OAuth, os termos e configurações opcionais e os serviços de nuvem do parceiro. Em seguida, a infraestrutura do parceiro retorna as credenciais do OAuth para o app cliente do Assistente. Os serviços de nuvem do parceiro enviam dispositivos e recursos disponíveis para os serviços do Assistente, que armazenam as informações no Home Graph.
Figura 1: interação entre a infraestrutura do Google e do parceiro

Para evitar desvincular e vincular novamente a conta de um usuário, envie uma solicitação de sincronização 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 mais informações.

Diagrama de fluxo de uma intent SYNC
Figura 2: intent de sincronização

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

CONSULTA

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

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

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

Para ter a melhor experiência do usuário, implemente o Estado do relatório para relatar de forma proativa o estado atual dos dispositivos de um usuário diretamente para Google Home Graph . For example, this lets Assistant know if your user turned on a smart light with a physical light switch.

Como informar o estado do dispositivo usando o estado do relatório
Figura 4: relatório do 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 fulfillment recebe uma intent action.devices.EXECUTE para o cumprimento que descreve a ação e os dispositivos a serem aplicados. Um usuário pode executar uma ação em um dispositivo com um comando como Ok Google, acenda as luzes da sala de estar.

Diagrama de fluxo de uma intent EXECUTE
Figura 5: EXECUÇÃO intenção

DESCONECTAR

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

Anterior
Tipos e características do dispositivo
Próxima
Fulfillment