Home Mobile SDK für Android

Google hat die App Google Home Mobile SDK entwickelt, um dir die Erstellung von Android-Apps zu erleichtern, die mit Matter-Geräten interagieren. Mobile SDK enthält zwei zentrale APIs, mit denen Ihre Apps Geräte in Betrieb nehmen und für die Google-Struktur freigeben können.

Nachdem ein Gerät zum Google-Fabric hinzugefügt wurde, können Nutzer ihre Geräte über die Google Home app (GHA)-, Android-Ein/Aus-Steuerung, Sprachsteuerung und Nest-Touchscreen-Geräte steuern.

Mit Mobile SDK können Sie auch einen benutzerdefinierten Provisionsdienst definieren, mit dem Sie Geräte in weiteren Matter-Systemen in Betrieb nehmen können.

Mobile SDK in Ihre Android-App einbinden

So gehts:

  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 Modul Play services-home ist optional. Die Funktion Matter ist daher nur dann auf dem Gerät eines Nutzers vorhanden, wenn eine App auf dem Gerät die entsprechende Modulabhängigkeit des Play services in der Datei AndroidManifest.xml angibt.

GHA und Google Home Sample App for Matter enthalten diese Modulabhängigkeit im Manifest. Wenn Sie das Mobile SDK in die Android-App einbinden, fügen Sie der application-Deklaration in der Datei AndroidManifest.xml den folgenden service-Block hinzu, damit Matter-Nutzer von der App unterstützt werden:

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

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

Ich rufe andere Android-Apps an

Wenn Sie Android 11 oder höher verwenden, müssen Sie den folgenden queries-Block in AndroidManifest.xml einfügen, damit Ihre App Aufrufe an andere Apps senden 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 Filter für die Paketsichtbarkeit auf Android-Geräten.

Google Home-Beispiel-App für Matter

Probiere unseren Sample App for Matter aus, um zu erfahren, wie das Mobile SDK in einer Android-App funktioniert.

Sample App for Matter ausprobieren

Eigene App erstellen

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

Zum Sample App for Matter-Codelab

Ressourcen

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

Informationen dazu, wie dieses SDK mit Endnutzerdaten umgeht, finden Sie im Abschnitt zur Datensicherheit für Google Play Mobile Home.