Este guia oferece orientações de UX para projetar permissões de dispositivo de APIs do Google Home e compartilhamento 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 do Google 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.
- É fundamental garantir que os dispositivos sejam apresentados de forma consistente em apps com suporte à API Home para evitar uma experiência 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 | APIs Home para permissões | Solicita aos usuários que concedam permissões ao app. Antes de usar qualquer uma das APIs da casa, o app precisa ter permissão para acessar dispositivos na casa do usuário (chamada na API de estrutura). No entanto, a ordem em que essa etapa é realizada depende do cenário do desenvolvedor e é incluída na 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 a fricção do usuário, recomendamos usar o recurso de link direto (disponível no Android e no iOS) que leva os usuários diretamente à página específica de vinculação de contas no GHA. |
| API de comissionamento | Comissionamento do Matter | Embora seja geralmente considerada uma API para comissionar novos dispositivos Matter, ela também pode ser usada 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 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 indicada. 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.
Chame a API Google Commissioning em cada dispositivo Matter comissionado anteriormente para outro fabric.
- Como o compartilhamento de 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 durante esse processo:
- Fornecer aos usuários uma lista de dispositivos Matter que não são 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.
- Retorno à 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 a entrada do usuário,
recomendamos que você oriente o usuário durante esse processo:
Você só produz dispositivos compartilhados com o Google usando APIs do Cloud para Cloud
Faça Cloud-to-cloud links diretos. Isso adiciona os dispositivos ao Google Home Graph.
- Recomendamos vincular 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.
Você produz dispositivos Matter e de nuvem para nuvem
Faça Cloud-to-cloud links diretos.
- Recomendamos vincular 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.
Chame a API Google Commissioning em cada dispositivo Matter comissionado anteriormente para outro fabric.
- Como o compartilhamento de 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 durante esse processo:
- Fornecer aos usuários uma lista de dispositivos Matter que não são 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.
- Retorno à 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 a entrada do usuário,
recomendamos que você oriente o usuário durante 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 de usuário importantes 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 apresentação oportuna do Google Home e compartilhar a experiência com seus usuários.
Eles também não são mutuamente exclusivos e têm 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 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 (vinculação de Cloud-to-cloud e a API Commissioning Matter) da permissão de apps (a API Permissions). Isso permite que os usuários controlem quais etapas são concluídas e oferece a oportunidade de mostrar o status de 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 do 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 ativação
Esse cenário seria principalmente para parceiros que produzem apenas dispositivos Matter (sem dispositivos Cloud-to-cloud) e não têm o próprio fabricante de Matter. O ponto de entrada do usuário pode aparecer logo após uma tela pronta 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 sobre comandos do usuário são:
Em geral, você deve solicitar que os usuários concluam apenas as etapas ausentes 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 acesso ao app 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. Como resultado, a conclusão da vinculação de Cloud-to-cloud não precisa ser um pré-requisito para solicitar permissões de APIs do Google Home.
Sugestões de design visual
Um benefício claro da integração ao Google Home (por exemplo, "Crie automações avançadas com o Google Home" ou "Controle dispositivos usando os apps que você escolher").
Uma chamada para ação (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 Matter especificamente, quando o usuário já tiver concedido acesso à casa pelo app Google Home, você poderá compartilhar os dispositivos da casa com o Google Home ao comissionar novos. Por exemplo, é possível adicionar um dispositivo Matter ao seu fabric e solicitar que o usuário adicione esse dispositivo ao fabric do Google.
Sugestões de conteúdo
É mais fácil confiar em algo que os usuários entendem e que agrega valor. Forneça informações para que os usuários tomem decisões mais informadas, incluindo trocas.
O passo 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 ao posicionamento da oferta.
- Faça uma proposta atraente, mas não prometa demais.
- Se o usuário precisar de um dispositivo mencionado no seu pitch, informe isso de forma clara para que ele não encontre um obstáculo inesperado.
- Você pode ter apenas uma oportunidade de capturar esses usuários, então aproveite.
Práticas recomendadas
- Comece pelo ponto de vista do usuário, a abordagem "o que isso tem a ver comigo?".
- 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, 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 alinhado com sua estratégia geral.
- Use frases úteis, como "Começar".