Home Mobile SDK for Android

Google は、Matter デバイスと連携する Android アプリを作成できるように、Google Home Mobile SDK を開発しました。Mobile SDK には、アプリがデバイスを Google ファブリックで試して共有できるようにする 2 つのコア API が含まれています。

デバイスが Google ファブリックに追加されると、ユーザーは Google Home app (GHA)、Android の電源コントロール、音声、Google 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 モジュールはオプションであるため、Matter 機能は、デバイス上のアプリが AndroidManifest.xml ファイルで適切な Play services モジュール依存関係を指定している場合にのみ、ユーザーのデバイス上に表示されます。

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 を使用して確認できます。詳細については、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 データ セーフティ セクションを参照してください。