Matter 기기와 상호작용하는 Android 애플리케이션을 빌드할 수 있도록 Google에서 Google Home Mobile SDK를 개발했습니다. Mobile SDK에는 앱이 기기를 커밋하고 Google 패브릭과 공유할 수 있게 해주는 두 가지 핵심 API가 포함되어 있습니다.
기기가 Google Fabric에 추가되면 사용자는 Google Home app (GHA), Android 전원 제어, 음성, Nest 터치 스크린 기기를 통해 기기를 제어할 수 있습니다.
Mobile SDK를 사용하면 추가 Matter 생태계에 기기를 커미셔닝하는 데 사용할 수 있는 맞춤 커미셔닝 서비스를 정의할 수도 있습니다.
Android 앱에 Mobile SDK 통합
시작하려면 다음 단계를 완료하세요.
Google Play services 설정에 제공된 안내를 따릅니다.
Play services 종속 항목을
build.gradle
파일에 추가합니다.implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
모듈 전송 보장
Play services home
모듈은 선택사항이므로 기기의 앱이 AndroidManifest.xml
파일에 적절한 Play services 모듈 종속 항목을 지정하는 경우에만 사용자 기기에 Matter 기능이 표시됩니다.
GHA 및 Google Home Sample App for Matter 모두 매니페스트에 이 모듈 종속 항목을 포함합니다. Mobile SDK를 Android 앱에 통합하는 경우 앱 사용자를 위한 Matter 지원을 보장하려면 AndroidManifest.xml
파일 내 application
선언에 다음 service
블록을 추가합니다.
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
이는 Play services 22.50.14 이상을 실행하는 Android 기기에서만 지원됩니다.
구현 예는 Sample App for Matter의 매니페스트를 참고하세요.
ModuleInstallClient
를 사용하여 런타임 시 Home 모듈 사용 가능 여부를 확인할 수 있습니다. 자세한 내용은 ModuleInstallClient를 사용하여 API 가용성 보장 페이지를 참고하세요.
다른 Android 앱에 전화 걸기
Android 11 이상을 사용하는 경우 앱이 다른 앱을 호출할 수 있도록 AndroidManifest.xml
에 다음 queries
블록을 포함해야 합니다.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
자세한 내용은 Android의 패키지 공개 상태 필터링 도움말을 참고하세요.
Matter용 Google Home 샘플 앱 사용하기
Android 앱에서 Mobile SDK가 작동하는 방식을 알아보려면 Sample App for Matter를 사용해 보세요.
나만의 앱 빌드
빠르게 시작할 수 있도록 Sample App for Matter를 오픈소스로 제공하고, 자체 Android 프로젝트에 맞게 샘플 코드를 맞춤설정할 수 있는 호환 Codelab을 제공했습니다.
Sample App for Matter Codelab으로 이동
리소스
Mobile SDK에 대한 자세한 내용은 API 참조를 확인하세요.
이 SDK가 최종 사용자 데이터를 처리하는 방법을 알아보려면 Home 모바일 SDK Google Play 데이터 보안 섹션을 참고하세요.