A API Commissioning no Android oferece suporte à multiadministração (ou multiadministrador) para Matter. Isso significa que a API Commissioning pode servir como comissário principal ou secundário do Matter e que você pode adicionar seu próprio comissário:
Como o principal comissário de Matter:
- Nesse modo, a estrutura do Google é adicionada primeiro, usando a UX do Google.
- Você pode adicionar um comissário personalizado.
- O comissário é chamado depois que o tecido do Google é adicionado ao dispositivo, e a janela de comissionamento Matter é reaberta.
- Se o Google não puder concluir o provisionamento para sua própria estrutura primeiro por qualquer motivo, seu serviço de provisionamento personalizado não será executado.
Como o comissário secundário do Matter:
- Nesse modo, é possível implementar sua própria UX de comissionamento e integração à própria estrutura (ou a outras estruturas).
- A API Google Commissioning pode ser chamada mais tarde com uma janela de comissionamento aberta para adicionar o tecido do Google. 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 a estrutura do Google (usando a API Commissioning) depois que o fluxo de provisionamento for concluído.
Como usar a API Commissioning como o principal comissário do Matter
Estas etapas mostram o fluxo de comissionamento completo e com todos os recursos 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 UX do Google assume o controle e mostra a tela Ler QR code 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 processo de inclusão 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 configuraçã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.
O app retoma o controle, e o comissário personalizado, se registrado, é executado agora.
Como usar a API Commissioning como o comissário secundário do Matter
Estas etapas mostram o fluxo de comissionamento do Matter, em que seu processo de comissionamento ocorre antes do processo do Google:
O usuário inicia o fluxo de comissionamento no seu app. Por exemplo, o usuário toca em Adicionar dispositivo.
Seu processo de UX de comissionamento é executado para adicionar um dispositivo à sua estrutura.
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 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 tecido do Google.