A API Commissioning no Android oferece suporte à administração múltipla (ou multiadministração) para Matter, o que significa que a API Commissioning pode servir como comissário principal ou secundário Matter e que você pode adicionar seu próprio comissário:
Como comissário principal do Matter:
- Nesse modo, o Fabric do Google é adicionado primeiro usando a experiência do usuário do Google.
- É possível adicionar um comissário personalizado.
- O comissário é chamado depois que o Fabric do Google é adicionado ao dispositivo e a Matter janela de comissionamento é reaberta.
- Se o Google não puder concluir o comissionamento para o próprio Fabric por qualquer motivo, o serviço de comissionamento personalizado não será executado.
Como comissário secundário do Matter Matter:
- Nesse modo, você pode implementar sua própria experiência de comissionamento e integração ao seu próprio Fabric (ou a outros Fabrics).
- A API Commissioning do Google pode ser chamada mais tarde com uma janela de comissionamento aberta para adicionar o Fabric do Google. Nesse modo, o Google recomenda que, quando um usuário final conceder permissão para usar as APIs Home, o app solicite ativamente que os usuários adicionem o Fabric do Google (usando a API Commissioning) após a conclusão do fluxo de comissionamento.
Como usar a API Commissioning como comissário principal do Matter
Estas etapas mostram o fluxo de comissionamento Matter completo do Matter preferido pelo Google:
O usuário inicia o fluxo de comissionamento no app. Por exemplo, o usuário toca em um botão chamado Adicionar dispositivo.
A experiência do usuário do Google assume o controle e mostra a tela Matter Ler código QR, permitindo que o usuário leia o código QR para iniciar o processo de configuração.
Na tela Conectar este dispositivo à sua Conta do Google, o usuário toca em Concordo para adicionar um dispositivo ao ecossistema do Google. Se o usuário tocar em Cancelar nessa tela, todo o comissionamento do dispositivo será encerrado imediatamente.
Na tela Escolher uma casa, o usuário seleciona a casa em que pode controlar o dispositivo. Se nenhuma casa estiver disponível, uma nova será criada. Se nenhum hub adequado for encontrado na casa ou se o usuário não tiver permissões, o processo de comissionamento será encerrado.
A tela Dispositivo conectado aparece em seguida, e o Matter processo de configuração é iniciado. O usuário pode escolher um nome de Área e de Dispositivos nessa tela.
A tela Preparando o dispositivo aparece quando o dispositivo é integrado ao Matter Fabric.
O app retoma o controle, e o comissário personalizado, se registrado, é executado agora.
Como usar a API Commissioning como comissário secundário do Matter
Estas etapas mostram o Matter fluxo de comissionamento em que o processo de comissionamento ocorre antes do processo de comissionamento do Google:
O usuário inicia o fluxo de comissionamento no app. Por exemplo, o usuário toca em Adicionar dispositivo.
O processo de experiência de comissionamento é executado para adicionar um dispositivo ao Fabric.
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 Google Home, o que provavelmente indica que ele quer fazer o comissionamento para o Google, você poderá acionar o processo de comissionamento.
O processo chama a API Commissioning e fornece o payload, que contém a senha, o discriminador e outras informações disponíveis.
O processo de comissionamento do Google adiciona o dispositivo ao Fabric do Google.