Este guia oferece orientações de UX para projetar permissões e compartilhamento de dispositivos das APIs 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 têm a oferecer, os usuários precisam compartilhar os dispositivos com o Google Home porque:
- É um requisito técnico para o Google usar esses dispositivos em automações.
- Isso ajuda a manter uma experiência consistente e flexível no Google Home.
- Garantir que os dispositivos sejam apresentados de forma consistente em todos os apps com a API Home é fundamental 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 app. Antes de usar qualquer uma das APIs Home, o app precisa ter permissão para acessar os dispositivos na casa do usuário (chamada de estrutura na API). No entanto, a ordem em que essa etapa é realizada depende do cenário do desenvolvedor e está incluída na implementação técnica. |
| Vinculação de nuvem para nuvem | Cloud-to-cloud 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 no Android e no iOS) que leva os usuários diretamente para sua página específica de vinculação de contas no GHA. |
| API Commissioning no Android | Comissionamento do Matter | Embpsa seja geralmente considerada uma API para comissionar novos dispositivos Matter, também é possível usar essa API para adicionar o fabric do Google a dispositivos Matter que já foram comissionados para outro fabric. Portanto, essa é uma ferramenta útil para o processo de integração. |
Implementação técnica
A maneira como você cria os fluxos de compartilhamento depende de quais dispositivos 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 que já foi comissionado em outro fabric.
- Como o compartilhamento de Matter precisa ser realizado para cada
dispositivo individualmente e há muitas telas que exigem entrada do usuário,
recomendamos que você oriente o usuário nesse 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 dessa lista.
- Retornar à 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 realizado para cada
dispositivo individualmente e há muitas telas que exigem entrada do usuário,
recomendamos que você oriente o usuário nesse processo:
Você só produz dispositivos compartilhados com o Google usando APIs do Cloud de nuvem para nuvem
Realizar Cloud-to-cloud links diretos. Isso adiciona os dispositivos ao Google Home Graph.
- Recomendamos realizar a vinculação do Cloud-to-cloud primeiro para evitar situações potencialmente confusas, como o usuário receber uma lista com 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
Realizar Cloud-to-cloud links diretos.
- Recomendamos realizar a vinculação do Cloud-to-cloud primeiro para evitar situações potencialmente confusas, como o usuário receber uma lista com 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 que já foi comissionado em outro fabric.
- Como o compartilhamento de Matter precisa ser realizado para cada
dispositivo individualmente e há muitas telas que exigem entrada do usuário,
recomendamos que você oriente o usuário nesse 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 dessa lista.
- Retornar à 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 realizado para cada
dispositivo individualmente e há muitas telas que exigem entrada do usuário,
recomendamos que você oriente o usuário nesse 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 ideais do usuário a serem consideradas ao desenvolver um app que usa as APIs Home.
Onde introduzir o compartilhamento de dispositivos no app
Essa não é uma lista completa, e você pode encontrar outras oportunidades para oferecer uma experiência de compartilhamento e apresentação do Google Home para seus usuários.
Eles também não são mutuamente exclusivos, e há vários pontos de entrada:
No menu "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.
É recomendável separar o compartilhamento de dispositivos (vinculação do Cloud-to-cloud e a API Commissioning do Matter) das permissões do app (API Permissions). Isso permite que os usuários controlem 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 continuar e, em seguida, passar rapidamente pelo fluxo de permissões.
Somente do comissionamento
Esse cenário é principalmente para parceiros que produzem apenas dispositivos Matter (sem dispositivos Cloud-to-cloud) e não têm uma rede Matter própria. 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 a permissão do app (pela API Permissions) fazem parte do mesmo fluxo de experiência do usuário.
Lógica de compartilhamento
Algumas sugestões de comandos do usuário:
Em geral, você deve solicitar que os usuários concluam apenas as etapas que faltam para fazer a integração com a plataforma. Por exemplo, clientes de longa data podem já estar compartilhando os 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 ao app acesso ao Google Home.
Vários administradores do Google Home podem compartilhar uma estrutura da casa do Google Home, e, em alguns casos, apenas uma conta pode ser usada para compartilhar dispositivos com o Google. Portanto, 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 o Google Home" ou "Controle dispositivos usando os apps que quiser").
Uma call-to-action (por exemplo, "Começar") e uma forma de cancelar se o usuário não quiser continuar.
Se houver espaço, uma explicação do que vai acontecer conforme o usuário avança pelas telas.
Para o Matter especificamente, quando o usuário já tiver concedido acesso à casa dele pelas APIs Home, você poderá compartilhar os dispositivos da casa com o Google Home ao comissionar novos. Por exemplo, é possível 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. Capacite os usuários fornecendo informações para que eles tomem decisões conscientes, incluindo as vantagens e desvantagens.
O argumento 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.
- Crie um título atraente, mas não prometa demais.
- Se o usuário precisar de um dispositivo mencionado na sua apresentação, deixe isso claro para que ele não se depare com um obstáculo inesperado.
- Talvez você só tenha uma oportunidade 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, a clareza e a compreensão podem ser mais importantes do que a 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 de acordo com sua estratégia geral.
- Use frases que incentivem ações, como "Começar".