홈 모바일 SDK 커미셔닝

이 페이지에서는 Google Home Mobile SDK에서 일부 커미셔닝 API 기능을 사용하는 방법을 설명합니다.

수수료 적용 가능한 탐색 알림 차단

Android 하프 시트 알림
그림 1: Android 절반 시트 알림의 예

기본적으로 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>

자세한 내용은 샘플 앱의 매니페스트를 참고하세요.

앱 선택 도구

앱 선택 도구

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

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

추천 앱

앱 선택 도구에 두 개의 추천 앱이 표시됩니다.

  • 첫 번째는 항상 Google Home app (GHA)입니다.
  • 두 번째는 기기가 기기의 VID 또는 PID와 연결된 Developer Console 프로젝트에 정의된 경우 기기 제조업체의 기본 앱을 위한 것입니다. 기기 제조업체 추천 커미셔닝 앱

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

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