Android의 Commissioning API용 멀티 관리자

Android의 커미셔닝 API는 Matter의 다중 관리(또는 다중 관리자)를 지원합니다. 즉, 커미셔닝 API가 기본 또는 보조 Matter 커미셔너 역할을 할 수 있으며 자체 커미셔너를 추가할 수 있습니다.

  • 기본 Matter 커미셔너:

    • 이 모드에서는 Google UX를 사용하여 Google 패브릭이 먼저 추가됩니다.
    • 맞춤 커미셔너를 추가할 수 있습니다.
      • 커미셔너는 Google 패브릭이 기기에 추가된 후 호출되고 Matter 커미셔닝 창이 다시 열립니다.
      • 어떤 이유로든 Google이 자체 패브릭에 먼저 커미셔닝을 완료할 수 없는 경우 맞춤 커미셔닝 서비스가 실행되지 않습니다.
  • 보조 Matter 커미셔너:

    • 이 모드에서는 자체 커미셔닝 UX를 구현하고 자체 패브릭 (또는 다른 패브릭)에 온보딩할 수 있습니다.
    • 나중에 열린 커미셔닝 창으로 Google 커미셔닝 API를 호출하여 Google 패브릭을 추가할 수 있습니다. 이 모드에서 Google은 최종 사용자가 홈 API를 사용할 수 있는 권한을 부여한 경우 커미셔닝 흐름이 완료된 후 앱이 커미셔닝 API를 사용하여 Google의 패브릭을 추가하도록 사용자에게 적극적으로 메시지를 표시할 것을 적극 권장합니다.

커미셔닝 API를 기본 Matter 커미셔너로 사용하는 방법

다음 단계는 Google에서 권장하는 Matter의 모든 기능을 갖춘 커미셔닝 흐름을 보여줍니다.

  1. 사용자가 앱에서 커미셔닝 흐름을 시작합니다. 예를 들어 사용자가 기기 추가라는 라벨이 지정된 버튼을 탭합니다.

  2. Google UX가 제어권을 가져와 Matter QR 코드 스캔 화면을 표시하여 사용자가 QR 코드를 스캔하여 설정 프로세스를 시작할 수 있도록 합니다.

  3. 기기를 Google 계정에 연결 화면에서 사용자는 동의를 탭하여 기기를 Google 생태계에 추가합니다. 사용자가 이 화면에서 취소를 탭하면 모든 기기 커미셔닝이 즉시 종료됩니다.

  4. 홈 선택 화면에서 사용자는 기기를 제어할 수 있는 홈을 선택합니다. 사용 가능한 홈이 없으면 새 홈이 생성됩니다. 홈에 적절한 허브가 없거나 사용자에게 권한이 없으면 커미셔닝 프로세스가 종료됩니다.

  5. 다음으로 기기 연결됨 화면이 표시되고 Matter 설정 프로세스가 시작됩니다. 사용자는 이 화면에서 방과 기기 이름을 선택할 수 있습니다.

  6. 기기가 Matter 패브릭에 온보딩되면 기기 준비 중 화면이 표시됩니다.

  7. 앱이 제어를 재개하고 등록된 경우 맞춤 커미셔너가 이제 실행됩니다.

커미셔닝 API를 보조 Matter 커미셔너로 사용하는 방법

다음 단계는 Google 커미셔닝 프로세스 전에 커미셔닝 프로세스가 발생하는 Matter 커미셔닝 흐름을 보여줍니다.

  1. 사용자가 앱에서 커미셔닝 흐름을 시작합니다. 예를 들어 사용자가 기기 추가를 탭합니다.

  2. 커미셔닝 UX 프로세스가 실행되어 패브릭에 기기를 추가합니다.

  3. 완료되면 사용자에 대한 지식을 기반으로 동작을 지정하여 후속 동작을 지시할 수 있습니다. 예를 들어 사용자가 Google Home API를 선택한 경우 이는 사용자가 Google에 커미셔닝하기를 원한다는 표시일 수 있으므로 커미셔닝 프로세스를 트리거할 수 있습니다.

  4. 프로세스에서 커미셔닝 API를 호출하고 비밀번호, 식별자, 기타 사용 가능한 정보가 포함된 페이로드를 제공합니다.

  5. Google 커미셔닝 프로세스를 통해 기기가 Google 패브릭에 추가됩니다.