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