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.