Android 向け Google Home Mobile SDK

Matter デバイスとやり取りする Android アプリケーションの作成を支援するため、Google は Google Home Mobile SDK を開発しました。Mobile SDK には、アプリがデバイスを Google ファブリックにコミッショニングして共有できるようにする 2 つのコア API が含まれています。

デバイスが Google ファブリックに追加されると、ユーザーは Google Home app (GHA)、Android の電源コントロール、音声、Nest タッチスクリーン デバイスを通じてデバイスを操作できるようになります。

また、Mobile SDK を使用して、デバイスを他の Matter エコシステムにコミッショニングするために使用できるカスタム コミッショニング サービスを定義することもできます。

Mobile SDK を Android アプリに統合する

開始するには、次の手順を完了します。

  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 でのパッケージの公開設定のフィルタリングに関する記事をご覧ください。

Google Home Sample App for Matter を使用する

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 データ セーフティ セクションをご覧ください。