Este guia oferece orientações de UX para criar permissões e compartilhamento de dispositivos das APIs Google Home integrados 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 o Google usar esses dispositivos em automações.
- Isso ajuda a manter uma experiência consistente e flexível do Google Home.
- Garantir que os dispositivos sejam apresentados de forma consistente em apps ativados pela API Home é fundamental para evitar a criação de uma experiência do usuário fragmentada e confusa, em que as pessoas 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 a estrutura). 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 | De nuvem para nuvem 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 o uso do recurso de link direto (disponível no Android e no iOS) que leva as pessoas diretamente à página de vinculação de contas específica no GHA. |
| API Commissioning no Android | Comissionamento do Matter | Embora geralmente seja considerada uma API para comissionar novos Matter dispositivos, você também pode usá-la para adicionar a estrutura do Google a Matter dispositivos que já foram comissionados para outra estrutura. 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 aos usuários uma experiência geral melhor.
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 Matter dispositivo comissionado anteriormente para outra estrutura.
- Como o compartilhamento Matter precisa ser realizado para cada
dispositivo individualmente e há muitas telas que exigem a entrada do usuário,
recomendamos que você oriente o usuário nesse processo:
- Fornecendo aos usuários uma lista de dispositivos Matter que não estão sendo compartilhados com o Google.
- Permitindo que os usuários iniciem o processo de compartilhamento de dispositivos (usando a API Commissioning) clicando nos dispositivos dessa lista.
- Retornando à lista de dispositivos Matter, mostrando o progresso da tarefa e o status de compartilhamento ao usuário.
- Como o compartilhamento Matter precisa ser realizado para cada
dispositivo individualmente e há muitas telas que exigem a entrada do usuário,
recomendamos que você oriente o usuário nesse processo:
Você só produz dispositivos compartilhados com o Google usando APIs de nuvem para nuvem
Realize a vinculação direta Cloud-to-cloud direta. Isso adiciona os dispositivos ao Google Home Graph.
- Recomendamos realizar a vinculação 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
Realize a vinculação direta Cloud-to-cloud direta.
- Recomendamos realizar a vinculação 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 Matter dispositivo Matter comissionado anteriormente para outra estrutura.
- Como o compartilhamento Matter precisa ser realizado para cada
dispositivo individualmente e há muitas telas que exigem a entrada do usuário,
recomendamos que você oriente o usuário nesse processo:
- Fornecendo aos usuários uma lista de dispositivos Matter que não estão sendo compartilhados com o Google.
- Permitindo que os usuários iniciem o processo de compartilhamento de dispositivos (usando a API Commissioning) clicando nos dispositivos dessa lista.
- Retornando à lista de dispositivos Matter, mostrando o progresso da tarefa e o status de compartilhamento ao usuário.
- Como o compartilhamento Matter precisa ser realizado para cada
dispositivo individualmente e há muitas telas que exigem a 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 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 exaustiva, e você pode encontrar outras oportunidades de oferecer uma experiência de compartilhamento e apresentação do Google Home oportuna para seus usuários.
Esses também não são mutuamente exclusivos, e há vários pontos de entrada:
Em um menu "Configurações"
Como os usuários provavelmente estão acostumados a configurar conexões com os ecossistemas do Google Home por meio de um menu de configurações, esse método permite que eles continuem com esse paradigma.
Talvez você queira separar o compartilhamento de dispositivos (Cloud-to-cloud linking and the Matter Commissioning API) da permissão 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 seria principalmente para parceiros que produzem apenas dispositivos Matter (sem dispositivos Cloud-to-cloud) e não têm a própria Matter estrutura. O ponto de entrada para o usuário pode ocorrer logo após uma tela do tipo "fora da caixa", em que o compartilhamento de Matter dispositivos (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 avisos ao usuário são:
Geralmente, você só precisa pedir aos usuários que concluam as etapas necessárias para integrar a plataforma. Por exemplo, clientes antigos 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 ao app acesso ao Google Home.
Vários administradores do Google Home podem estar compartilhando uma estrutura da casa do Google Home e, em alguns casos, apenas uma conta pode ser usada para compartilhar dispositivos com o Google. Como resultado, a conclusão da vinculação Cloud-to-cloud não precisa ser um pré-requisito para solicitar permissões das APIs Home.
Sugestões de design visual
Um benefício claro da integração ao Google Home (por exemplo, "Crie automações avançadas com tecnologia do Google Home" ou "Controle dispositivos usando os apps de sua escolha").
Uma chamada para ação (por exemplo, "Começar") e uma maneira de cancelar se o usuário não quiser continuar.
Se o espaço permitir, uma explicação do que vai acontecer à medida que o usuário avança pelas telas.
Para Matter especificamente, quando o usuário já tiver concedido acesso à casa dele pelas APIs Home, você poderá compartilhar os dispositivos na casa dele com o Google Home ao comissionar novos. Por exemplo, você pode adicionar um Matter dispositivo à sua estrutura e, em seguida, pedir ao usuário para adicionar este 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 tomar decisões informadas, incluindo compensações.
A apresentação crítica
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 à forma como você posiciona a oferta.
- Deixe a oferta 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 encontre um obstáculo inesperado.
- Você só tem 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: 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 perder a atenção do usuário. No entanto, clareza e compreensão podem ser mais importantes do que ser conciso.
- As automações são divertidas! Escolha um exemplo interessante, mas útil, se o espaço permitir.
- Tente usar uma voz e um tom divertidos se isso estiver alinhado à sua estratégia geral.
- Use frases acionáveis, como "Começar".