홈 모바일 SDK 커미셔닝

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

수수료 적용 가능한 검색 알림 억제

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

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

추천 앱

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

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

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

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