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 데이터 보안 섹션을 참고하세요.