홈 모바일 SDK 커미셔닝

이 페이지에서는 Google Home Mobile SDK의 일부 커미셔닝 API 기능 사용에 대해 설명합니다.

수수료 지급 가능 탐색 알림 숨기기

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

기본적으로 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. 사용자가 다른 앱 선택을 선택하면 설치된 다른 앱 화면에 표시됩니다.

추천 앱

앱 선택 도구에 추천 앱 2개가 표시됩니다.

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

앱이 앱 선택 화면에 표시되는 경우는 두 가지입니다.

  1. 설치됨: Play services 애플리케이션이 ACTION_COMMISSION_DEVICE 인텐트 필터를 지원하는지 확인합니다. 인텐트 필터가 없으면 사용자는 앱을 업데이트하기 위해 Play 스토어로 이동합니다.
  2. 설치되지 않음: 계속하기 전에 사용자가 Play 스토어로 이동하여 앱을 설치합니다.