A API Commissioning oferece suporte à administração múltipla (ou multiadministrador) para Matter, o que significa que a API Commissioning pode servir como o emissor de Matter primário ou secundário e que você pode adicionar seu próprio emissor:
Como o comissário principal de Matter:
- Nesse modo, o Google Fabric é adicionado primeiro, usando a UX do Google.
- É possível adicionar um comissário personalizado.
- O comissário é chamado depois que o Google Fabric é adicionado ao dispositivo, e a janela de comissionamento Matter é reaberta.
- Se o Google não conseguir concluir a ativação no próprio fabric primeiro por qualquer motivo, o serviço de ativação personalizado não será executado.
Como o comissário secundário de Matter:
- Nesse modo, você pode implementar sua própria UX de comissionamento e integrar ao próprio fabric (ou a outros).
- A API Google Commissioning pode ser chamada mais tarde com uma janela de comissionamento aberta para adicionar o fabric do Google. Nesse modo, o Google recomenda fortemente que, quando um usuário final conceder a permissão para usar as APIs Home, o app solicite ativamente que os usuários adicionem o fabric do Google (usando a API Commissioning) depois que o fluxo de comissionamento for concluído.
Como usar a API Commissioning como o comissário principal do Matter
Estas etapas mostram o fluxo de comissionamento Matter com todos os recursos e preferido pelo Google:
O usuário inicia o fluxo de comissionamento no app. Por exemplo, ele toca em um botão com a mensagem Adicionar dispositivo.
A UX do Google assume o controle e exibe a tela Scan Matter QR Code, 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, toda a ativação do dispositivo será encerrada imediatamente.
Na tela Choose a home, o usuário seleciona a casa em que pode controlar o dispositivo. Se nenhuma casa estiver disponível, uma nova será criada. Se não forem encontrados hubs apropriados na casa ou se o usuário não tiver permissões, o processo de comissionamento será encerrado.
A tela Device connected vai aparecer em seguida, e o processo de configuração do Matter vai começar. O usuário pode escolher um nome de sala e de dispositivo nessa tela.
A tela Preparar o dispositivo aparece quando o dispositivo é integrado ao fabric Matter.
O app retoma o controle, e o comissário personalizado, se registrado, é executado.
Como usar a API Commissioning como o iniciador secundário do Matter
Estas etapas mostram o fluxo de comissionamento Matter, em que seu processo de comissionamento ocorre antes do processo de comissionamento do Google:
O usuário inicia o fluxo de comissionamento no app. Por exemplo, ele toca em Adicionar dispositivo.
Seu processo de comissionamento de UX é executado para adicionar um dispositivo ao fabric.
Depois de concluído, você pode determinar o comportamento subsequente 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 ativação no Google, você poderá iniciar o processo de ativação.
O processo chama a API de comissionamento 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.