커미셔닝 API를 사용하는 앱의 커미셔닝 흐름은 앱에서 직접 또는 빠른 페어링 프로세스의 앱 선택기를 통해 두 가지 방법으로 시작할 수 있습니다. 이 섹션에서는 각 기능의 사용자 환경 (UX)을 다룹니다.
앱에서 시작
이 시나리오에서 사용자는 일반적으로 '기기 추가'라는 클릭 유도 문구 (CTA)를 통해 앱에서 커미셔닝을 시작합니다. 다음과 같이 기기 추가 버튼을 표시하는 것이 좋습니다.
- 사용자가 컨트롤 페이지와 같이 모든 기기를 볼 수 있는 위치
- 사용자가 홈을 관리할 수 있는 위치(예: 설정 페이지)
- 앱의 홈 페이지
커미셔닝이 완료되면 사용자를 앱의 홈페이지로 안내하거나, 사용자가 방금 설정한 기기 컨트롤러를 표시하거나 방금 설정한 기기를 포함한 모든 기기의 전체 목록을 표시하는 앱의 위치로 안내하는 것이 좋습니다.
UX는 그림 2에 설명되어 있습니다.
앱 사용자가 기기 추가를 클릭합니다.
사용자가 QR 코드를 스캔하거나 페어링 코드를 입력합니다.
사용자에게 기기를 Google 패브릭에 추가하는 데 동의하고 (그림 1의 '동의 + 메타데이터'에 해당) 사용할 Google 계정을 선택하라는 메시지가 표시됩니다.
사용자에게 홈이 두 개 이상 있는 경우 홈을 선택하라는 메시지가 표시됩니다. 홈이 설정되어 있지 않으면 '홈'이라는 홈이 자동으로 생성됩니다.
커미셔닝 API가 기기에 연결됩니다.
사용자에게 기기가 있는 방을 선택하라는 메시지가 표시됩니다.
사용자에게 기기 이름을 변경하라는 메시지가 표시됩니다.
커미셔닝 API는 Matter 사용자 인증 정보를 생성하고, 네트워크 연결을 확인한 후, 커미셔닝 프로세스를 실행하여 기기를 선택한 패브릭에 연결합니다.
사용자의 구조 및 기기에 대한 권한이 이미 부여된 경우 기기가 해당 홈의 다른 기기와 함께 홈에 표시되며 앱을 사용하여 제어할 수 있습니다.
사용자의 구조 및 기기에 대한 권한이 아직 부여되지 않은 경우 기기가 앱에 표시되지 않거나 아직 제어할 수 없습니다. 앱에서 기기에 액세스하고 기기를 제어하려면 권한이 필요합니다.
빠른 페어링에 의해 시작됨
Android의 빠른 페어링을 사용하여 커미셔닝을 시작할 수도 있습니다. 기기의 Matter QR 코드를 스캔하면 사용자는 커미셔닝 프로세스를 계속할 앱을 선택하라는 메시지가 표시됩니다. 앱을 선택하면 그림 3에 표시된 것처럼 앱의 커미셔닝 API가 사용됩니다.
사용자가 휴대기기에 앱을 설치하지 않은 경우 계속하기 전에 설치하라는 메시지가 표시됩니다. 동의 화면부터의 UX는 그림 2와 동일합니다.
사용자에게 QR 코드를 스캔하라는 메시지가 표시됩니다.
사용자가 기기의 Matter QR 코드를 스캔합니다.
사용자에게 커미셔닝 프로세스를 계속할 앱을 선택하라는 메시지가 표시됩니다.
앱이 아직 설치되어 있지 않은 경우 사용자에게 설치하라는 메시지가 표시됩니다.
앱이 Google Play 스토어에서 다운로드됩니다.
앱이 설치되어 있습니다.
앱이 성공적으로 설치되면 사용자에게 계속하라는 메시지가 표시됩니다.
사용자에게 기기를 Google 패브릭에 추가하는 데 동의하고 (그림 1의 '동의 + 메타데이터'에 해당) 사용할 Google 계정을 선택하라는 메시지가 표시됩니다.
사용자에게 홈이 두 개 이상 있는 경우 홈을 선택하라는 메시지가 표시됩니다. 홈이 설정되어 있지 않으면 '홈'이라는 홈이 자동으로 생성됩니다.
커미셔닝 API가 기기에 연결됩니다.
사용자에게 기기가 있는 방을 선택하라는 메시지가 표시됩니다.
사용자에게 기기 이름을 변경하라는 메시지가 표시됩니다.
커미셔닝 API는 Matter 사용자 인증 정보를 생성하고 네트워크 연결을 확인한 후 커미셔닝 프로세스를 실행하여 기기를 선택한 패브릭에 연결합니다.
사용자의 구조 및 기기에 대한 권한이 이미 부여된 경우 기기가 해당 홈의 다른 기기와 함께 홈에 표시되며 앱을 사용하여 제어할 수 있습니다.
사용자의 구조 및 기기에 대한 권한이 아직 부여되지 않은 경우 앱에서 기기가 아직 표시되거나 제어되지 않아야 합니다. 앱에서 기기에 액세스하고 기기를 제어하려면 권한이 필요합니다.
앱 선택기
커미셔닝 프로세스 중에 앱이 앱 선택기에 표시되는 방법에는 두 가지가 있습니다.
- 앱 선택 화면
- 사용자가 다른 앱 선택을 선택하면 기타 설치된 앱 화면에 표시됩니다.
추천 앱
앱 선택기에 추천 앱 두 개가 표시됩니다.
- 첫 번째는 항상 Google Home app (GHA)입니다.
- 두 번째는 기기의 VID 또는 PID와 연결된 Google Home Developer Console 프로젝트에 정의된 경우 기기 제조업체의 기본 앱입니다. (이 옵션은 Matter 기기를 빌드하지 않는 앱 개발자에게는 적용되지 않습니다.)
앱이 앱 선택 화면에 있는 경우 두 가지 시나리오가 있습니다.
- 설치됨 - Google Play services 애플리케이션이
ACTION_COMMISSION_DEVICE인텐트 필터를 지원하는지 확인합니다. 인텐트 필터가 누락된 경우 사용자는 Play 스토어로 안내되어 앱을 업데이트합니다. - 설치되지 않음 - 사용자가 계속 진행하기 전에 앱을 설치하도록 Play 스토어로 안내됩니다.