Este guia fornece orientações de UX para projetar permissões e compartilhamento de dispositivos das APIs do Google Home para a experiência de integração no seu aplicativo.
Os principais tópicos descritos aqui são:
- Por que compartilhar dispositivos com o Google Home?
- Principais fases do fluxo de compartilhamento
- Implementação técnica
- Práticas recomendadas de UX
Por que compartilhar dispositivos com o Google Home?
Para aproveitar os recursos que as APIs Home oferecem, os usuários precisam compartilhar os dispositivos com o Google Home porque:
- É um requisito técnico para que o Google use esses dispositivos em automações.
- Isso ajuda a manter uma experiência consistente e flexível do Google Home.
- É fundamental garantir que os dispositivos sejam apresentados de forma consistente em todos os apps compatíveis com a API Home para evitar uma experiência do usuário fragmentada e confusa, em que os usuários precisam alternar entre apps para realizar tarefas básicas.
Principais componentes do fluxo de compartilhamento
| Componente | Programa | Descrição |
|---|---|---|
| API Permissions no Android | APIs Home para permissões no Android | Solicita que os usuários concedam permissões ao seu app. Antes de usar qualquer uma das APIs Home, seu app precisa ter permissão para acessar dispositivos na casa do usuário (referida na API como estrutura). A ordem em que essa etapa é realizada, no entanto, depende do cenário do desenvolvedor e está incluída em Implementação técnica. |
| Vinculação de nuvem para nuvem | Entre nuvens para vinculação de contas | Permite iniciar o processo de vinculação de contas para compartilhar dispositivos conectados à nuvem com o Google Home no seu app. Para reduzir o atrito do usuário, recomendamos usar o recurso de link direto (disponível para Android e iOS) que leva os usuários diretamente à página específica de vinculação de contas no GHA. |
| API de comissionamento no Android | Comissionamento do Matter | Embora geralmente seja considerada uma API para comissionar novos dispositivos Matter, também é possível usá-la para adicionar o tecido do Google a dispositivos Matter que já foram comissionados para outro tecido. Portanto, essa é uma ferramenta útil para o processo de integração. |
Implementação técnica
A maneira de criar os fluxos de compartilhamento depende dos dispositivos que você planeja compartilhar com o Google.
Para os cenários a seguir, recomendamos seguir as etapas na ordem fornecida. Isso ajuda a oferecer uma experiência geral melhor para os usuários.
Você só produz dispositivos Matter
Você produz dispositivos compatíveis com o Matter que quer comissionar para o Google Home.
Chame a API Permissions no Android.
Chame a API Commissioning no Android em cada dispositivo Matter comissionado anteriormente para outra estrutura.
- Como o compartilhamento de Matter precisa ser feito para cada
dispositivo individualmente, e há muitas telas que exigem entrada do usuário,
recomendamos que você guie o usuário por esse processo:
- Fornecer aos usuários uma lista de dispositivos Matter que não estão sendo compartilhados com o Google.
- Permitir que os usuários iniciem o processo de compartilhamento de dispositivos (usando a API Commissioning) clicando nos dispositivos nessa lista.
- Retornando à lista de dispositivos Matter, mostrando o progresso da tarefa e o status de compartilhamento para o usuário.
- Como o compartilhamento de Matter precisa ser feito para cada
dispositivo individualmente, e há muitas telas que exigem entrada do usuário,
recomendamos que você guie o usuário por esse processo:
Você só produz dispositivos compartilhados com o Google usando APIs de nuvem para nuvem.
Faça Cloud-to-cloud links diretos. Isso adiciona os dispositivos ao Home Graph do Google.
- Recomendamos fazer a vinculação do Cloud-to-cloud primeiro para evitar situações potencialmente confusas, como o usuário receber uma lista que contém dispositivos compartilhados com o Google e dispositivos não compartilhados com o Google.
Chame a API Permissions no Android.
Você produz dispositivos de nuvem para nuvem e Matter
Faça Cloud-to-cloud links diretos.
- Recomendamos fazer a vinculação do Cloud-to-cloud primeiro para evitar situações potencialmente confusas, como o usuário receber uma lista que contém dispositivos compartilhados com o Google e dispositivos não compartilhados com o Google.
Chame a API Permissions no Android.
Chame a API Commissioning para Android em cada dispositivo Matter previamente provisionado para outra estrutura.
- Como o compartilhamento de Matter precisa ser feito para cada
dispositivo individualmente, e há muitas telas que exigem entrada do usuário,
recomendamos que você guie o usuário por esse processo:
- Fornecer aos usuários uma lista de dispositivos Matter que não estão sendo compartilhados com o Google.
- Permitir que os usuários iniciem o processo de compartilhamento de dispositivos (usando a API Commissioning) clicando nos dispositivos nessa lista.
- Retornando à lista de dispositivos Matter, mostrando o progresso da tarefa e o status de compartilhamento para o usuário.
- Como o compartilhamento de Matter precisa ser feito para cada
dispositivo individualmente, e há muitas telas que exigem entrada do usuário,
recomendamos que você guie o usuário por esse processo:
Você não tem dispositivos para compartilhar com o Google
Chame a API Permissions.
Práticas recomendadas de UX
Esta seção contém algumas jornadas críticas do usuário a serem consideradas ao desenvolver um app que aproveita as APIs Home.
Onde apresentar o compartilhamento de dispositivos no app
Esta não é uma lista completa, e você pode encontrar outras oportunidades de oferecer uma experiência de compartilhamento e sugestão do Google Home oportuna para seus usuários.
Elas também não são mutuamente exclusivas, e há vários pontos de entrada:
Em um menu de configurações
Como os usuários provavelmente estão acostumados a configurar conexões com os ecossistemas do Google Home usando um menu de configurações, esse método permite que eles continuem com esse paradigma.
Talvez você queira separar o compartilhamento de dispositivos (vinculação Cloud-to-cloud e API de provisionamento Matter) das permissões de apps (API Permissions). Isso dá aos usuários a capacidade de controlar quais etapas eles concluem e oferece uma oportunidade para você mostrar o status da conexão ao usuário.
Ao usar dispositivos em automações executadas pelo Google
Na guia "Automações", os usuários podem tocar em um ponto de entrada para o fluxo de compartilhamento, ler uma tela de proposta de valor que explica claramente os benefícios de seguir em frente e, em seguida, passar rapidamente pelo fluxo de permissões.
Apenas da comissão
Esse cenário é principalmente para parceiros que produzem apenas dispositivos Matter (sem dispositivos Cloud-to-cloud) e não têm sua própria estrutura Matter. O ponto de entrada para o usuário pode vir logo após uma tela do tipo "pronto para uso", em que o compartilhamento de dispositivos Matter (pela API Commissioning) e as permissões do app (pela API Permissions) fazem parte do mesmo fluxo de experiência do usuário.
Lógica de compartilhamento
Algumas sugestões sobre solicitações ao usuário:
Em geral, peça aos usuários para concluir apenas as etapas necessárias para integrar a plataforma. Por exemplo, clientes de longa data podem já estar compartilhando dispositivos de um OEM com o Google. Nesse caso, eles só precisam passar pelo processo de concessão de permissões das APIs Home para dar acesso ao app ao Google Home.
Vários administradores do Google Home podem compartilhar uma estrutura do Google Home, e, em alguns casos, apenas uma conta pode ser usada para compartilhar dispositivos com o Google. Por isso, concluir a vinculação do Cloud-to-cloud não deve ser um pré-requisito para solicitar permissões das APIs Home.
Sugestões de design visual
Um benefício claro de usar o Google Home (por exemplo, "Crie automações avançadas com tecnologia do Google Home" ou "Controle dispositivos usando os apps que quiser").
Uma call-to-action (por exemplo, "Começar") e uma maneira de cancelar se o usuário não quiser continuar.
Se houver espaço, uma explicação do que vai acontecer à medida que o usuário avança pelas telas.
Para o Matter especificamente, quando o usuário já concedeu acesso à casa dele pelas APIs Home, é possível compartilhar os dispositivos da casa com o Google Home ao configurar novos aparelhos. Por exemplo, você pode adicionar um dispositivo Matter à sua estrutura e pedir que o usuário adicione esse dispositivo à estrutura do Google.
Sugestões de conteúdo
É mais fácil para os usuários confiarem em algo que entendem e que agrega valor. Dê autonomia aos usuários fornecendo informações para que eles tomem decisões embasadas, incluindo compensações.
O tom crítico
Os usuários não vão continuar compartilhando dispositivos se não houver uma proposta de valor forte para isso.
- Preste atenção especial em como você posiciona a oferta.
- Deixe o título atraente, mas não prometa demais.
- Se o usuário precisar de um dispositivo mencionado na sua sugestão, deixe isso claro para que ele não encontre um obstáculo inesperado.
- Você só tem uma chance de capturar esses usuários, então faça valer a pena.
Práticas recomendadas
- Comece com o ponto de vista do usuário, ou seja, a abordagem "o que eu ganho com isso?".
- Não escreva mais de quatro linhas de conteúdo em um bloco de seção. Mais palavras podem fazer o usuário perder a atenção. No entanto, clareza e compreensão podem ser mais importantes do que concisão.
- As automações são divertidas! Escolha um exemplo interessante, mas útil, se houver espaço.
- Tente usar uma voz e um tom divertidos se isso estiver alinhado à sua estratégia geral.
- Use frases práticas, como "Começar".