Поддержка нескольких администраторов в Commissioning API на устройствах Android

API инициализации на Android поддерживает многоадминистрирование (или несколько администраторов) для Matter. Это означает, что API инициализации может выступать в качестве основного или дополнительного администратора Matter и что вы можете добавить собственного администратора:

  • Как основной комиссар Matter:

    • В этом режиме сначала добавляется структура Google с помощью интерфейса Google.
    • Вы можете добавить собственного уполномоченного.
      • После того как в устройство будет добавлена структура Google, вызывается ваш комиссар, а затем снова открывается окно инициализации Matter.
      • Если Google не сможет выполнить инициализацию в своей сети Fabric по какой-либо причине, ваш сервис инициализации не запустится.
  • В качестве уполномоченного по вопросам среднего образованияMatter:

    • В этом режиме можно реализовать собственный интерфейс для настройки и подключения к собственной сети или другим сетям.
    • Позже можно вызвать Google Commissioning API с открытым окном инициализации, чтобы добавить сеть Google. В этом режиме Google настоятельно рекомендует, чтобы после завершения процесса инициализации приложение активно предлагало пользователям добавить сеть Google (с помощью Commissioning API), если они предоставили вам разрешение на использование Home API.

Как использовать Commissioning API в качестве основного контроллера Matter

Ниже описан рекомендуемый Google Matterполнофункциональный процесс инициализации.

  1. Пользователь запускает процесс настройки в приложении. Например, он нажимает кнопку Добавить устройство.

  2. Интерфейс Google UX переходит под управление и показывает экран Отсканируйте Matter QR-код, позволяя пользователю отсканировать QR-код, чтобы начать процесс настройки.

  3. На экране Свяжите это устройство с своим аккаунтом Google пользователь нажимает Принимаю, чтобы добавить устройство в экосистему Google. Если пользователь нажмет на этом экране кнопку Отмена, настройка устройства будет немедленно прекращена.

  4. На экране Выберите дом пользователь выбирает дом, из которого он может управлять устройством. Если дома нет, он будет создан. Если в доме не будет найдено подходящих хабов или у пользователя не будет необходимых разрешений, процесс настройки завершится.

  5. Затем появится экран Устройство подключено и начнется процесс настройки Matter. На этом экране пользователь может выбрать название переговорной комнаты и устройства.

  6. На экране Настройка устройства показывается, как устройство подключается к сети Matter.

  7. Приложение снова получает управление, и запускается зарегистрированный пользовательский комиссар.

Как использовать Commissioning API в качестве дополнительного контроллера Matter

Ниже описан процесс ввода в эксплуатацию Matter, в котором ваш процесс ввода в эксплуатацию происходит до процесса ввода в эксплуатацию Google:

  1. Пользователь запускает процесс настройки в вашем приложении. Например, он нажимает Добавить устройство.

  2. Вы добавляете устройство в связанную группу, используя интерфейс инициализации.

  3. После этого вы можете определить дальнейшее поведение, основываясь на своих знаниях о пользователе. Например, если пользователь согласился на использование Google Home API, это может означать, что он хочет выполнить инициализацию в Google. В этом случае вы можете запустить процесс инициализации.

  4. Ваш процесс вызывает Commissioning API и предоставляет полезную нагрузку, которая содержит код доступа, дискриминатор и другую доступную информацию.

  5. В процессе инициализации устройство добавляется в группу Google.