Home Mobile SDK für Android

Google hat die Google Home Mobile SDK entwickelt, um Ihnen beim Erstellen von Android-Anwendungen zu helfen, die mit Matter-Geräten interagieren. Die Mobile SDK umfasst zwei Haupt-APIs, mit denen Ihre Apps Geräte über die Google Fabric in Betrieb nehmen und freigeben können.

Sobald ein Gerät der Google Fabric hinzugefügt wurde, können Nutzer ihre Geräte über die Google Home app (GHA), die Android-Ein/Aus-Steuerung, per Sprachbefehl und über Nest-Touchscreens steuern.

Mit Mobile SDK können Sie auch einen benutzerdefinierten Inbetriebnahmedienst definieren, mit dem Sie Geräte für zusätzliche Matter-Umgebungen in Betrieb nehmen können.

Mobile SDK in Ihre Android-App einbinden

Führen Sie die folgenden Schritte aus:

  1. Folgen Sie der Anleitung unter Google Play services einrichten.

  2. Fügen Sie der Datei build.gradle die Abhängigkeit Play services hinzu:

    implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'

Modulbereitstellung sicherstellen

Das Play services-home-Modul ist optional. Die Matter-Funktionen sind daher nur auf dem Gerät eines Nutzers verfügbar, wenn eine App auf dem Gerät die entsprechende Play services-Modulabhängigkeit in ihrer AndroidManifest.xml-Datei angibt.

GHA und Google Home Sample App for Matter enthalten beide diese Modulabhängigkeit in ihrem Manifest. Wenn Sie die Mobile SDK in Ihre Android-Anwendung einbinden, fügen Sie der application-Deklaration in Ihrer AndroidManifest.xml-Datei den folgenden service-Block hinzu, um Matter-Unterstützung für Nutzer Ihrer App zu ermöglichen:

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

Dies wird nur für Android-Geräte mit Play services 22.50.14 oder höher unterstützt.

Eine Beispielimplementierung finden Sie im Manifest von Sample App for Matter.

Mit ModuleInstallClient können Sie die Verfügbarkeit des Home-Moduls während der Laufzeit prüfen. Weitere Informationen finden Sie auf der Seite API-Verfügbarkeit mit ModuleInstallClient gewährleisten.

Andere Android-Apps aufrufen

Wenn Sie Android 11 oder höher verwenden, müssen Sie den folgenden queries-Block in den AndroidManifest.xml einfügen, damit Ihre App andere Apps aufrufen kann.

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

Weitere Informationen finden Sie im Artikel Filterung der Paketsichtbarkeit auf Android.

Beispiel-App für Google Home für Matter verwenden

Wenn Sie wissen möchten, wie die Mobile SDK in einer Android-App funktioniert, sehen Sie sich unsere Sample App for Matter an.

Sample App for Matter ausprobieren

Eigene App erstellen

Damit Sie schnell loslegen können, haben wir die Sample App for Matter als Open Source veröffentlicht und ein Codelab bereitgestellt, mit dem Sie unseren Beispielcode für Ihre eigenen Android-Projekte anpassen können.

Zum Codelab zu Sample App for Matter

Ressourcen

Weitere Informationen zu Mobile SDK finden Sie in der API-Referenz.

Weitere Informationen dazu, wie mit Endnutzerdaten in diesem SDK umgegangen wird, finden Sie im Abschnitt zur Datensicherheit von Google Play für das Home Mobile SDK.