Home Mobile SDK für Android

Damit du Android-Apps entwickeln kannst, die mit Matter-Geräten interagieren, hat Google das Google Home Mobile SDK entwickelt. Das Mobile SDK enthält zwei Haupt-APIs, mit denen deine Apps Geräte in der Google-Fabric in Betrieb nehmen und teilen können.

Sobald ein Gerät zur Google-Fabric hinzugefügt wurde, können deine Nutzer ihre Geräte über die Google Home app (GHA), die Android-Energiesteuerung, die Sprachsteuerung und Nest-Touchscreen-Geräte steuern.

Mit dem Mobile SDK kannst du auch einen benutzerdefinierten Dienst für die Inbetriebnahme definieren, mit dem du Geräte in zusätzlichen Matter-Ökosystemen in Betrieb nehmen kannst.

Mobile SDK in Ihre Android-App einbinden

Führen Sie folgende 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'

Präsentation des Moduls

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

Sowohl GHA als auch Google Home Sample App for Matter enthalten diese Modulabhängigkeit in ihrem Manifest. Wenn Sie das Mobile SDK in Ihre Android-App einbinden, müssen Sie den folgenden service-Block zur application-Deklaration in Ihrer AndroidManifest.xml-Datei hinzufügen, um die Matter-Unterstützung für Nutzer Ihrer App zu gewährleisten:

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

Du kannst die Verfügbarkeit des Home-Moduls zur Laufzeit mit ModuleInstallClient prüfen. Weitere Informationen finden Sie auf der Seite API-Verfügbarkeit mit ModuleInstallClient sicherstellen.

Andere Android-Apps aufrufen

Wenn Sie Android 11 oder höher verwenden, müssen Sie den folgenden queries-Block in die 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 Paketsichtbarkeitsfilterung unter Android.

Google Home-Beispiel-App für Matter verwenden

Wenn Sie wissen möchten, wie die Mobile SDK in einer Android-App funktioniert, probieren Sie unser Sample App for Matter aus.

Sample App for Matter ausprobieren

Eigene App erstellen

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

Zum Codelab Sample App for Matter

Ressourcen

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

Informationen dazu, wie dieses SDK mit Endnutzerdaten umgeht, findest du im Google Play-Abschnitt zur Datensicherheit für das Home Mobile SDK.