As intents de casa inteligente são objetos de mensagens simples que descrevem qual ação do smart home realizar, como ligar uma luz ou transmitir áudio para um alto-falante.
Todas as intents smart home estão contidas no
namespace action.devices
, e é necessário fornecer fulfillment para elas. Sempre que
Google Assistant envia uma intent para o 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:
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 os dispositivos com Google Home app (GHA), ele também é autenticado na sua infraestrutura em nuvem. Em seguida,
Assistant recebe um token OAuth2. Neste ponto,
Assistant envia uma intent action.devices.SYNC
para seu
fulfillment para recuperar a lista inicial de dispositivos e recursos do usuário
da infraestrutura em nuvem.

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.

Durante a configuração do fulfillment local, a
plataforma Home Home confere a resposta SYNC
do
fulfillment de nuvem da sua ação smart home. 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.

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. Por exemplo, isso permite que Assistant saiba se o usuário ligou um dispositivo de iluminação inteligente usando um interruptor físico.

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.

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