Android용 Home Mobile SDK

Matter 기기와 상호작용하는 Android 애플리케이션을 빌드할 수 있도록 Google에서 Google Home Mobile SDK를 개발했습니다. Mobile SDK에는 앱이 Google Fabric으로 기기를 커미셔닝하고 공유할 수 있는 두 가지 핵심 API가 포함되어 있습니다.

기기가 Google Fabric에 추가되면 사용자는 Google Home app (GHA), Android 전원 제어, 음성, Nest 터치 스크린 기기를 통해 기기를 제어할 수 있습니다.

Mobile SDK를 사용하면 추가 Matter 생태계로 기기를 커미셔닝하는 데 사용할 수 있는 커스텀 커미셔닝 서비스를 정의할 수도 있습니다.

Android 앱에 Mobile SDK 통합

시작하려면 다음 단계를 완료하세요.

  1. Google Play services 설정에 제공된 안내를 따릅니다.

  2. 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

나만의 앱 빌드

빠르게 시작할 수 있도록 Sample App for Matter를 오픈소스로 제공하고, 자체 Android 프로젝트에 맞게 샘플 코드를 맞춤설정할 수 있는 호환 Codelab을 제공했습니다.

Sample App for Matter Codelab으로 이동

리소스

Mobile SDK에 관한 자세한 내용은 API 참조를 참고하세요.

이 SDK가 최종 사용자 데이터를 처리하는 방법을 알아보려면 Home Mobile SDK Google Play 데이터 보안 섹션을 참고하세요.