O fluxo de comissionamento no seu app usando a API Commissioning pode ser iniciado de duas maneiras: diretamente no seu app ou por um seletor de apps no processo de Pareamento rápido. Esta seção aborda a experiência do usuário (UX) para cada um deles.
Iniciado pelo app
Nesse cenário, o usuário inicia o comissionamento no seu app, normalmente em uma chamada para ação (CTA) de "Adicionar dispositivo". Recomendamos que você destaque o botão Adicionar dispositivo da seguinte maneira:
- 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 Configurações.
- A página Inicial do seu app.
Quando o comissionamento estiver concluído, recomendamos que o usuário acesse a página inicial do app ou um local no app que mostre o controlador do dispositivo que acabou de ser configurado ou uma lista completa de todos os dispositivos, incluindo o que acabou de ser configurado.
A UX é 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 ao Google Fabric (isso corresponde a "Consentimento + metadados" na Figura 1) e selecionar a Conta do Google a ser usada.
Se o usuário tiver mais de uma casa, ele vai precisar selecionar uma. Se ele não tiver uma casa configurada, uma casa chamada "Casa" será criada automaticamente.
A API Commissioning se conecta ao dispositivo.
O usuário precisa selecionar o cômodo em que o dispositivo está localizado.
O usuário precisa renomear o dispositivo.
A API Commissioning gera Matter credenciais, 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 na casa com outros dispositivos 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 ou poderá ser controlado no app. A permissão é necessária para acessar e controlar o dispositivo em um app.
Iniciado pelo Pareamento rápido
O comissionamento também pode ser iniciado usando o Pareamento rápido no Android. Depois de ler o QR code Matterdo dispositivo, o usuário precisa selecionar um app para continuar o processo de comissionamento. A seleção do seu 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 precisar instalar antes de continuar. A UX da tela de permissão em diante é a mesma da Figura 2.
O usuário precisa ler um QR code.
O usuário lê o QR code do dispositivo Matter.
O usuário precisa selecionar um app para continuar o comissionamento.
Se o app ainda não estiver instalado, o usuário vai precisar instalá-lo.
O app é baixado da Google Play Store.
O app está instalado.
Depois que o app for instalado, o usuário vai precisar continuar.
O usuário precisa concordar em adicionar o dispositivo ao Google Fabric (isso corresponde a "Consentimento + metadados" na Figura 1) e selecionar a Conta do Google a ser usada.
Se o usuário tiver mais de uma casa, ele vai precisar selecionar uma. Se ele não tiver uma casa configurada, uma casa chamada "Casa" será criada automaticamente.
A API Commissioning se conecta ao dispositivo.
O usuário precisa selecionar o cômodo em que o dispositivo está localizado.
O usuário precisa renomear o dispositivo.
A API Commissioning gera Matter credenciais, 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 na casa com outros dispositivos 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 ou poderá ser controlado no app. A permissão é necessária para acessar e controlar o dispositivo em um app.
Seletor de apps
Há duas maneiras de o app aparecer no seletor de apps durante o processo de comissionamento:
- Na tela Escolher um app.
- Se os usuários selecionarem Escolher outro app, ele vai aparecer na tela Outros apps instalados.
Apps sugeridos
O seletor de apps mostra dois apps sugeridos.
- O primeiro é sempre Google Home app (GHA).
- O segundo é para o app preferido do fabricante do dispositivo, se ele estiver definido em um
Google Home Developer Console projeto associado ao VID ou PID do
dispositivo. Essa opção não se aplica a desenvolvedores de apps que não
criam Matter dispositivos.
Há dois cenários quando os apps estão na tela Escolher um app.
- Instalado : Google Play services verifica se o aplicativo oferece suporte
ao filtro de intent
ACTION_COMMISSION_DEVICE. Se o filtro de intent estiver ausente, o usuário será direcionado à Play Store para atualizar o app. - Não instalado : o usuário é direcionado à Play Store para instalar o app antes de continuar.