A API de Comissionamento no Android suporta multi-administração (ou multi-admin) para Matter, o que significa que a API de Comissionamento pode servir como comissionador primário ou secundário Matter e que você pode adicionar seu próprio comissionador:
Como comissário principal Matter:
- Nesse modo, a interface do Google é adicionada primeiro, utilizando a experiência do usuário do Google (Google UX).
- Você pode adicionar um comissário personalizado.
- Seu comissário é contatado depois que o Google Fabric é adicionado ao dispositivo, então a janela de comissionamento Matter é reaberta.
- Se, por algum motivo, o Google não conseguir concluir o comissionamento em sua própria infraestrutura primeiro, seu serviço de comissionamento personalizado não será executado.
Como comissário secundário do Matter:
- Nesse modo, você pode implementar sua própria experiência de usuário (UX) para comissionamento e integrá-la à sua própria plataforma (ou a outras plataformas).
- A API de comissionamento do Google pode ser chamada posteriormente, com uma janela de comissionamento aberta, para adicionar a infraestrutura do Google. Nesse modo, o Google recomenda fortemente que, quando um usuário final conceder permissão para usar as APIs do Google Home, o aplicativo solicite ativamente que os usuários adicionem a infraestrutura do Google (usando a API de Comissionamento) após a conclusão do fluxo de comissionamento.
Como usar a API de Comissionamento como comissário principal do Matter
Estas etapas mostram a preferência do Google.Matter Fluxo de comissionamento completo:
O usuário inicia o fluxo de comissionamento no aplicativo. Por exemplo, o usuário toca em um botão rotulado Adicionar dispositivo.
A interface do usuário do Google assume o controle e exibe a tela Escanear Matter Código QR, permitindo que o usuário escaneie o código QR para iniciar o processo de configuração.
Na tela Conecte este dispositivo à sua conta do Google, o usuário toca em Concordo para adicionar um dispositivo ao ecossistema do Google. Se, em vez disso, o usuário tocar em Cancelar nesta tela, todo o comissionamento do dispositivo será encerrado imediatamente.
Na tela Escolher uma casa, o usuário seleciona a casa a partir da qual poderá controlar o dispositivo. Se não houver nenhuma casa disponível, uma nova casa é criada. Caso não sejam encontrados hubs adequados na residência, ou se o usuário não tiver as permissões necessárias, o processo de ativação será encerrado.
A tela Dispositivo conectado vai aparecer em seguida, e o processo de configuração do Matter vai começar. Nessa tela, o usuário pode escolher um nome para a sala e o dispositivo.
A tela Preparando seu dispositivo aparece quando o dispositivo é integrado à estrutura Matter.
Seu aplicativo retoma o controle e o comissário personalizado, se registrado, é executado agora.
Como usar a API de Comissionamento como comissário secundário do Matter
Estas etapas mostram o fluxo de comissionamento Matter onde seu processo de comissionamento ocorre antes do processo de comissionamento do Google:
O usuário inicia o fluxo de comissionamento no seu aplicativo. Por exemplo, o usuário toca em Adicionar dispositivo.
O processo de UX (Experiência do Usuário) comissionado é executado para adicionar um dispositivo à sua plataforma.
Depois de concluído, você pode ditar o comportamento resultante com base no seu conhecimento do usuário. Por exemplo, se o usuário tiver ativado as APIs do Google Home, o que provavelmente indica que ele quer fazer a inclusão no Google, você poderá acionar o processo de inclusão.
Seu processo chama a API de Comissionamento e fornece a carga útil, que contém a senha, o discriminador e outras informações disponíveis.
O processo de comissionamento do Google adiciona o dispositivo à infraestrutura do Google.