Commissioning API на Android поддерживает мультиадминистрирование (multi-admin) для Matter. Это означает, что Commissioning API может служить основным или дополнительным уполномоченным Matter и что вы можете добавить собственного уполномоченного:
Как основной заказчик Matter:
- В этом режиме сначала добавляется структура Google с использованием UX Google.
- Вы можете добавить собственного комиссионера.
- Ваш комиссионер вызывается после того, как на устройство добавляется структура Google, а затем окно ввода в эксплуатацию Matter открывается повторно.
- Если Google по какой-либо причине не сможет сначала завершить ввод в эксплуатацию в своей сети, ваш сервис ввода в эксплуатацию не запустится.
Как комиссар Matter:
- В этом режиме вы можете реализовать собственный интерфейс ввода в эксплуатацию и подключить устройство к своей или другой сети.
- Google Commissioning API можно вызвать позже, когда будет открыто окно ввода в эксплуатацию, чтобы добавить сеть Google. В этом режиме Google настоятельно рекомендует, чтобы после того, как конечный пользователь предоставил вам разрешение на использование Home API, приложение активно предлагало пользователям добавить фабрику Google (с помощью Commissioning API) после завершения процесса ввода в эксплуатацию.
Как использовать Commissioning API в качестве основного контроллера Matter
Ниже описан рекомендуемый Google Matter полный процесс ввода в эксплуатацию.
Пользователь запускает процесс ввода в эксплуатацию в приложении. Например, нажимает кнопку Добавить устройство.
Google UX берет управление на себя и отображает экран Отсканируйте QR-код Matter. Пользователь сможет отсканировать QR-код, чтобы начать настройку.
На экране Свяжите это устройство со своим аккаунтом Google пользователь нажимает Принимаю, чтобы добавить устройство в экосистему Google. Если пользователь нажмет Отмена, ввод устройства в эксплуатацию будет немедленно прекращен.
На экране Выберите дом пользователь выбирает дом, из которого он может управлять устройством. Если дома нет, он будет создан. Если в доме нет подходящих контроллеров или у пользователя нет разрешений, процесс ввода в эксплуатацию завершается.
Появится экран Устройство подключено, и начнется процесс настройки Matter. На этом экране пользователь может выбрать комнату и название устройства.
Появится экран Идет настройка устройства, пока устройство подключается к сети Matter.
Управление возвращается вашему приложению, и запускается пользовательский уполномоченный, если он зарегистрирован.
Как использовать Commissioning API в качестве дополнительного контроллера Matter
Ниже описан процесс ввода в эксплуатацию Matter, в котором ваш процесс ввода в эксплуатацию происходит до процесса ввода в эксплуатацию Google.
Пользователь запускает процесс ввода в эксплуатацию в вашем приложении, например нажимает Добавить устройство.
Чтобы добавить устройство в сеть, запустите процесс инициализации.
После этого вы можете определить дальнейшие действия на основе того, что вы знаете о пользователе. Например, если пользователь дал согласие на использование Google Home API, что, скорее всего, указывает на то, что он хочет ввести устройство в эксплуатацию в Google, вы можете запустить этот процесс.
Ваш процесс вызывает Commissioning API и предоставляет полезную нагрузку, которая содержит код доступа, дискриминатор и другую доступную информацию.
В процессе инициализации Google устройство добавляется в сеть Google.