Процесс инициализации в приложении с помощью Commissioning API можно запустить двумя способами: непосредственно в приложении или через окно выбора приложений в процессе быстрого подключения. В этом разделе описывается пользовательский интерфейс для каждого из них.
Инициировано приложением
В этом случае пользователь запускает настройку в вашем приложении, обычно нажав кнопку "Добавить устройство". Мы рекомендуем размещать кнопку Добавить устройство следующим образом:
- Страница, на которой пользователи видят все свои устройства, например страница Управление.
- Место, где пользователи могут управлять домом, например страница Настройки.
- Главная страница приложения.
После завершения ввода в эксплуатацию мы рекомендуем перенаправлять пользователя на главную страницу приложения или в раздел, где показывается контроллер только что настроенного устройства или полный список всех устройств, включая только что настроенное.
На рисунке 2 показан пример интерфейса.
Пользователь приложения нажимает Добавить устройство.
Пользователь сканирует QR-код или вводит код подключения.
Пользователю предлагается добавить устройство в сеть Google (это соответствует пункту "Согласие + метаданные" на рисунке 1) и выбрать аккаунт Google.
Если у пользователя несколько домов, ему будет предложено выбрать один из них. Если у пользователя не настроен дом, он будет создан автоматически.
API инициализации подключается к устройству.
Пользователю будет предложено выбрать комнату, в которой находится устройство.
Пользователю будет предложено переименовать устройство.
API инициализации создает учетные данные Matter, проверяет подключение к сети, а затем выполняет процесс инициализации, подключая устройство к выбранной сети.
Если разрешение на доступ к структуре и устройствам пользователя уже предоставлено, устройство должно появиться на главном экране вместе с другими устройствами в этом доме. Им можно управлять с помощью приложения.
Если разрешение на доступ к структуре и устройствам пользователя ещё не предоставлено, устройство не должно быть видно в приложении и им нельзя управлять. Разрешение необходимо для доступа к устройству и управления им в приложении.
Инициировано быстрым подключением
На устройствах Android инициализировать ввод в эксплуатацию также можно с помощью быстрого подключения. После сканирования QR-кода Matter устройства пользователю будет предложено выбрать приложение, чтобы продолжить настройку. При выборе приложения используется API ввода в эксплуатацию из приложения, как показано на рисунке 3.
Если приложение не установлено на мобильном устройстве пользователя, ему будет предложено установить его. Интерфейс, начиная с окна запроса доступа, такой же, как на рисунке 2.
Пользователю будет предложено отсканировать QR-код.
Пользователь сканирует Matter QR-код устройства.
Пользователю предлагается выбрать приложение, чтобы продолжить процесс настройки.
Если приложение ещё не установлено, пользователю будет предложено сделать это.
Приложение скачивается из Google Play.
Приложение установлено.
После успешной установки приложения пользователю будет предложено продолжить.
Пользователю предлагается добавить устройство в сеть Google (это соответствует пункту "Согласие + метаданные" на рисунке 1) и выбрать аккаунт Google.
Если у пользователя несколько домов, ему будет предложено выбрать один из них. Если у пользователя не настроен дом, он будет создан автоматически.
API инициализации подключается к устройству.
Пользователю будет предложено выбрать комнату, в которой находится устройство.
Пользователю будет предложено переименовать устройство.
API инициализации создает учетные данные Matter, проверяет подключение к сети, а затем выполняет процесс инициализации, подключая устройство к выбранной сети.
Если разрешение на доступ к структуре и устройствам пользователя уже предоставлено, устройство должно появиться на главном экране вместе с другими устройствами в этом доме, и им можно будет управлять с помощью приложения.
Если разрешение на доступ к структуре и устройствам пользователя ещё не предоставлено, устройство не должно быть видно в приложении и им нельзя управлять. Разрешение необходимо для доступа к устройству и управления им в приложении.
Выбор приложения
Приложение может появиться в списке приложений во время настройки двумя способами:
- На экране Выберите приложение.
- Если пользователи выберут Другое приложение, оно будет показано на экране Другие установленные приложения.
Рекомендуемые приложения
В окне выбора приложений показаны два рекомендованных приложения.
- Первый всегда Google Home app (GHA).
- Второй вариант – предпочтительное приложение производителя устройства, если оно указано в проекте Google Home Developer Console, связанном с VID или PID устройства. (Этот вариант не подходит для разработчиков приложений, которые не создают устройства Matter.)
Приложения могут появиться на экране Выберите приложение в двух случаях:
- Установлено – Google Play services убедитесь, что приложение поддерживает фильтр интентов
ACTION_COMMISSION_DEVICE. Если фильтр интентов отсутствует, пользователь будет перенаправлен в Google Play, чтобы обновить приложение. - Не установлено. Пользователь будет перенаправлен в Google Play, чтобы установить приложение, прежде чем продолжить.