홈 모바일 SDK 커미셔닝

이 페이지에서는 Google Home Mobile SDK에서 특정 커미셔닝 API 기능의 사용을 다룹니다.

커미셔닝 가능한 기기 검색 알림 억제

기본적으로 Android의 Google Play services는 모바일 기기 화면의 하단 절반을 덮는 '하프시트' 알림을 사용하여 사용자에게 커미셔닝 가능한 Matter 기기가 근처에 있음을 사전 예방적으로 표시합니다.

앱이 포그라운드에 있는 동안 중단되지 않도록 하려면 Mobile SDK에서 suppressHalfSheetNotification() 메서드를 호출하여 이러한 알림을 억제하면 됩니다. 자세한 내용은 API 문서를 참고하세요.

이 API로 사용 설정된 억제는 앱이 15분 이상 포그라운드에 있으면 타임아웃됩니다. 타임아웃 후 억제를 다시 사용 설정하려면 suppressHalfSheetNotification()를 다시 호출하세요. 그렇지 않으면 절반 시트 알림이 표시되기 시작합니다.

이 API의 구현은 Google Home Sample App for Matter에서 확인할 수 있습니다. 자세한 내용은 HalfSheetSuppressionObserver.kt을 참조하세요.

Matter 커미셔닝 지원 표시

Mobile SDK를 사용하여 커미셔닝하는 경우 Google Home Developer Console에 앱 패키지 이름을 추가하고, Matter API를 구현하고, ACTION_COMMISSION_DEVICE 인텐트를 처리하여 앱이 Matter 커미셔닝을 지원한다고 표시해야 합니다.

AndroidManifest.xml 파일 내의 application 선언에 다음 intent-filter를 추가합니다.

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

참고용 샘플 앱의 매니페스트를 확인하세요.

앱 선택기

커미셔닝 프로세스 중에 앱이 앱 선택기에 표시되는 방법에는 두 가지가 있습니다.

1. 앱 선택 화면
2. 사용자가 다른 앱 선택을 선택하면 기타 설치된 앱 화면에 표시됩니다.

추천 앱

앱 선택기에 추천 앱 두 개가 표시됩니다.

• 첫 번째는 항상 Google Home app (GHA)입니다.
• 두 번째는 기기의 VID 또는 PID와 연결된 Developer Console 프로젝트에 정의된 경우 기기 제조업체의 기본 앱입니다.

앱이 앱 선택 화면에 있는 경우 두 가지 시나리오가 있습니다.

1. 설치됨 - Play services 애플리케이션이 ACTION_COMMISSION_DEVICE 인텐트 필터를 지원하는지 확인합니다. 인텐트 필터가 누락된 경우 사용자는 Play 스토어로 안내되어 앱을 업데이트합니다.
2. 설치되지 않음 - 사용자가 계속 진행하기 전에 앱을 설치하도록 Play 스토어로 안내됩니다.