Android용 홈 모바일 SDK

Matter 기기와 상호작용하는 Android 애플리케이션을 빌드할 수 있도록 Google에서는 Google Home Mobile SDK를 개발했습니다. Mobile SDK에는 앱이 Google 패브릭과 기기를 커밋하고 공유할 수 있게 해주는 두 가지 핵심 API가 포함되어 있습니다.

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

Mobile SDK를 사용하면 기기를 추가 Matter 생태계에 수수료하는 데 사용할 수 있는 맞춤 수수료 서비스를 정의할 수도 있습니다.

Android 앱에 모바일 SDK 통합

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

Google Play services 설정의 안내를 따릅니다.

build.gradle 파일에 Play services 종속 항목을 추가합니다.

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이 앱 사용자를 지원하도록 다음 service 블록을 AndroidManifest.xml 파일 내 application 선언에 추가합니다.

<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를 사용하여 런타임에 홈 모듈 가용성을 확인할 수 있습니다. 자세한 내용은 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를 오픈소스로 제공하고 컴패니언 Codelab을 제공하여 자체 Android 프로젝트에 맞게 샘플 코드를 맞춤설정할 수 있습니다.

Sample App for Matter Codelab으로 이동

자료

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

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