Android 向け Google Home Mobile SDK

Google Play とやり取りする Android アプリを Matter デバイス向けに開発されました。 Google Home Mobile SDK。「 Mobile SDK には、アプリで次のことを可能にする 2 つのコア API が含まれています。 デバイスをコミッショニングして Google ファブリックで共有します。

デバイスが 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 はどちらもこれを含む モジュールの依存関係をマニフェスト内で使用しないでください。統合する場合は Android アプリにMobile SDKして、 Matter サポートをアプリのユーザー向けにサポートするには、 service 宣言のapplicationブロックの後に AndroidManifest.xml ファイル:

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

これに対応しているのは、以下を搭載した Android 台のデバイスのみです。 Play services 22.50.14 以降。

Sample App for Matter の マニフェスト をご覧ください。

実行時に Google Home モジュールを使用できるかどうかは、 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。

<ph type="x-smartling-placeholder"></ph> Sample App for Matter を試す

独自のアプリを作成する

すぐに使用を開始できるように、 Sample App for Matter と、コンパニオン Codelab が用意されています。 サンプルコードをご自身でカスタマイズできます。

<ph type="x-smartling-placeholder"></ph> Sample App for Matter Codelab に移動する

リソース

Mobile SDK について詳しくは、以下をご覧ください。 API リファレンス。

この SDK によるエンドユーザー データの取り扱いについては、Home Mobile SDK の Google Play のデータ セーフティ セクションを参照してください。