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