O fluxo de comissionamento em seu aplicativo usando a API de Comissionamento pode ser iniciado de duas maneiras: diretamente no seu aplicativo ou por meio de um seletor de aplicativos no processo Fast Pair. Esta seção aborda a experiência do usuário (UX) para cada um deles.
Iniciado pelo aplicativo
Nesse cenário, o usuário inicia o provisionamento no seu app, normalmente em uma call-to-action (CTA) de "Adicionar dispositivo". Recomendamos destacar o botão Adicionar dispositivo da seguinte forma:
- Onde os usuários veem todos os dispositivos, como uma página Controles
- Onde os usuários podem gerenciar a casa, como uma página de Configurações
- A página Início do seu app
Após a conclusão da configuração, recomendamos direcionar o usuário para a página inicial do aplicativo ou para uma seção do aplicativo que mostre o controlador do dispositivo que ele acabou de configurar ou uma lista completa de todos os dispositivos, incluindo o dispositivo que acabou de ser configurado.
A experiência do usuário é ilustrada na Figura 2:
O usuário do app clica em Adicionar dispositivo.
O usuário lê o QR code ou insere o código de pareamento.
O usuário precisa concordar em adicionar o dispositivo à estrutura do Google (isso corresponde a "Consentimento + metadados" na Figura 1) e selecionar a Conta do Google a ser usada.
Se o usuário tiver mais de um Home, ele vai precisar selecionar um. Se não tiverem uma casa configurada, uma casa chamada "Casa" será criada automaticamente.
A API Commissioning se conecta ao dispositivo.
O usuário vai precisar selecionar o ambiente em que o dispositivo está localizado.
O usuário recebe uma solicitação para renomear o dispositivo.
A API Commissioning gera credenciais Matter, verifica a conectividade de rede e executa o processo de comissionamento, conectando o dispositivo ao fabric escolhido.
Se a permissão para a estrutura e os dispositivos do usuário já tiver sido concedida, o dispositivo vai aparecer no Google Home junto com outros dispositivos da casa e poderá ser controlado usando o app.
Se a permissão para a estrutura e os dispositivos do usuário ainda não tiver sido concedida, o dispositivo não vai aparecer nem poderá ser controlado no app. É necessário ter permissão para acessar e controlar o dispositivo em um app.
Iniciado pelo Pareamento rápido
A inclusão também pode ser iniciada usando o Fast Pair no Android. Depois de ler o QR code Matter do dispositivo, o usuário precisa selecionar um app para continuar o processo de inclusão. A seleção do app usa a API Commissioning do app, conforme ilustrado na Figura 3.
Se o usuário não tiver o app instalado no dispositivo móvel, ele vai receber uma solicitação para fazer isso antes de continuar. A UX da tela de consentimento em diante é a mesma da Figura 2.
O usuário é solicitado a ler um QR code.
O usuário lê o Matter QR code do dispositivo.
O usuário precisa selecionar um app para continuar o processo de configuração.
Se o app ainda não estiver instalado, o usuário vai receber uma solicitação para fazer isso.
O app é baixado da Google Play Store.
O app está instalado.
Depois que o app for instalado, o usuário receberá uma solicitação para continuar.
O usuário precisa concordar em adicionar o dispositivo à estrutura do Google (isso corresponde a "Consentimento + metadados" na Figura 1) e selecionar a Conta do Google a ser usada.
Se o usuário tiver mais de um Home, ele vai precisar selecionar um. Se eles não tiverem uma página inicial configurada, uma página inicial chamada "Home" será criada automaticamente.
A API Commissioning se conecta ao dispositivo.
O usuário vai precisar selecionar o ambiente em que o dispositivo está localizado.
O usuário recebe uma solicitação para renomear o dispositivo.
A API Commissioning gera credenciais Matter, verifica a conectividade de rede e executa o processo de comissionamento, conectando o dispositivo ao tecido escolhido.
Se a permissão para a estrutura e os dispositivos do usuário já tiver sido concedida, o dispositivo vai aparecer no Google Home junto com outros dispositivos da casa e poderá ser controlado usando o app.
Se a permissão para a estrutura e os dispositivos do usuário ainda não tiver sido concedida, o dispositivo não vai aparecer nem poderá ser controlado no app. É necessária permissão para acessar e controlar o dispositivo em um aplicativo.
Seletor de apps
Há duas maneiras de seu app aparecer no seletor de apps durante o processo de comissionamento:
- Na tela Escolha um aplicativo.
- Se os usuários selecionarem Escolher outro aplicativo, ele será exibido na tela Outros aplicativos instalados.
Aplicativos sugeridos
O seletor de apps mostra dois apps sugeridos.
- O primeiro é sempre Google Home app (GHA).
- O segundo é para o aplicativo preferido do fabricante do dispositivo, se estiver definido em um projeto Google Home Developer Console associado ao VID ou PID do dispositivo. Essa opção não se aplica a desenvolvedores de apps que não criam dispositivos Matter.
Existem dois cenários quando os aplicativos estão na tela Escolha um aplicativo.
- Instalado - Google Play services verifique se o aplicativo suporta o filtro de intenção
ACTION_COMMISSION_DEVICE. Caso o filtro de intenção esteja ausente, o usuário será direcionado para a Play Store para atualizar o aplicativo. - Não instalado: o usuário é direcionado à Play Store para instalar o app antes de continuar.