홈 모바일 SDK 커미셔닝

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

커미셔닝 가능한 기기 검색 알림 표시 안 함

Android Halfsheet Notification(Android Halfsheet 알림)
그림 1: Android 하프시트 알림의 예

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

앱이 포그라운드에 있는 동안 중단을 방지하려면 에서 suppressHalfSheetNotification() 메서드를 호출하여 이러한 알림을 표시하지 않도록 하면 됩니다.Mobile SDK 자세한 내용은 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 스토어로 이동하여 앱을 설치합니다.