A API Commissioning no Android oferece suporte à multiadministração (ou multi-admin) para o Matter, o que significa que a API Commissioning pode servir como o administrador principal ou secundário do Matter e que você pode adicionar seu próprio administrador:
Como administrador principal do Matter:
- Nesse modo, o Google Fabric é adicionado primeiro, usando a UX do Google.
- É possível adicionar um comissário personalizado.
- O comissionador é chamado depois que o fabric do Google é adicionado ao dispositivo. Em seguida, a janela de comissionamento Matter é reaberta.
- Se o Google não conseguir concluir o comissionamento na própria estrutura primeiro por qualquer motivo, seu serviço de comissionamento personalizado não será executado.
Como comissário secundário do Matter:
- Nesse modo, é possível implementar sua própria UX de comissionamento e integração ao próprio fabric (ou a outros fabrics).
- A API Google Commissioning pode ser chamada mais tarde com uma janela de comissionamento aberta para adicionar o Google Fabric. Nesse modo, o Google recomenda que, quando um usuário final conceder permissão para usar as APIs Home, o app peça ativamente aos usuários para adicionar o fabric do Google (usando a API Commissioning) após a conclusão do fluxo de comissionamento.
Como usar a API Commissioning como o comissário principal do Matter
Estas etapas mostram o fluxo de comissionamento completo do Matter, preferido pelo Google:
O usuário inicia o fluxo de comissionamento no app. Por exemplo, ele toca em um botão chamado Adicionar dispositivo.
A UX do Google assume o controle e mostra a tela Ler o QR code do Matter, permitindo que o usuário leia o QR code 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 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 não houver uma casa 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 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 o ambiente e o dispositivo.
A tela Preparando seu dispositivo aparece quando o dispositivo é integrado à rede Matter.
O app retoma o controle, e o comissário personalizado, se registrado, é executado.
Como usar a API Commissioning como o comissário secundário do Matter
Estas etapas mostram o fluxo de comissionamento do Matter, em que o processo de comissionamento ocorre antes do processo de comissionamento do Google:
O usuário inicia o fluxo de comissionamento no seu app. Por exemplo, ele toca em Adicionar dispositivo.
O processo de UX de comissionamento é executado para adicionar um dispositivo ao fabric.
Depois de concluído, você pode ditar o comportamento seguinte com base no seu conhecimento do usuário. Por exemplo, se o usuário tiver aceitado as APIs Google Home, o que provavelmente é uma indicação de que ele quer fazer o comissionamento para o Google, você pode acionar o processo de comissionamento.
Seu 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 Google Fabric.