이 페이지에서는 Google Home Mobile SDK에서 일부 커미셔닝 API 기능을 사용하는 방법을 설명합니다.
수수료 적용 가능한 검색 알림 억제
기본적으로 Android의 Google Play services는 휴대기기 화면의 하단을 덮는 '하프시트' 알림을 사용하여, 수수료로 사용할 수 있는 Matter 기기가 근처에 있다는 것을 사용자에게 사전에 알립니다.
앱이 포그라운드에 있을 때 중단을 방지하려면 Mobile SDK에서 suppressHalfSheetNotification()
메서드를 호출하여 이러한 알림을 억제할 수 있습니다. 자세한 내용은 API 문서를 참조하세요.
앱이 15분 넘게 포그라운드에 있는 경우 이 API로 사용 설정된 비표시 기능이 타임아웃됩니다. 시간 초과 후 비표시 기능을 다시 사용 설정하려면 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>
자세한 내용은 샘플 앱의 매니페스트를 참고하세요.
앱 선택 도구
커미셔닝 프로세스 중에 앱이 앱 선택 도구에 표시되는 방법에는 두 가지가 있습니다.
- 앱 선택 화면에서
- 사용자가 다른 앱 선택을 선택하면 다른 설치된 앱 화면에 해당 앱이 표시됩니다.
추천 앱
앱 선택 도구에 추천 앱 2개가 표시됩니다.
- 첫 번째는 항상 Google Home app (GHA)입니다.
- 두 번째는 기기 제조업체의 기본 앱에 관한 것입니다(기기의 VID 또는 PID와 연결된 Developer Console 프로젝트에 정의된 경우).
앱이 앱 선택 화면에 표시되는 경우는 두 가지입니다.
- 설치됨 - Play services: 애플리케이션이
ACTION_COMMISSION_DEVICE
인텐트 필터를 지원하는지 확인합니다. 인텐트 필터가 없으면 앱을 업데이트할 수 있도록 사용자가 Play 스토어로 이동됩니다. - 설치되지 않음 - 계속하기 전에 앱을 설치할 수 있도록 사용자가 Play 스토어로 이동합니다.