As intents de casa inteligente são objetos de mensagens simples que descrevem qual ação do smart home executar, 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 para elas. Sempre que
Google Assistant envia uma intent para o fulfillment, o token de acesso do OAuth 2
de terceiros de um usuário é transmitido no cabeçalho de autorização.
Estas são as intents smart home com suporte:
SINCRONIZAR
A intent action.devices.SYNC
é usada para solicitar a lista de
dispositivos smart home que o usuário conectou e estão
disponíveis para uso.
Quando um usuário configura os dispositivos com o Google Home app (GHA), ele também
é autenticado na infraestrutura em nuvem. Em seguida, Assistant recebe um token OAuth2. Neste ponto,
Assistant envia uma intent action.devices.SYNC
ao
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 ver mais
informações.

Durante a configuração do fulfillment local, a
plataforma local do Google Home verifica a resposta SYNC
do
fulfillment na nuvem da ação smart home. Para saber mais sobre como
modificar a 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
de dispositivos smart home.
Quando os usuários consultam 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 a melhor experiência do usuário, implemente o Estado do relatório 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 ativou uma iluminação inteligente com um interruptor de luz física.

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 realização 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, acenda as luzes da sala de estar.

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.