Home Mobile SDK für Android

Um Sie bei der Entwicklung von Android-Apps zu unterstützen, die mit Matter-Geräten hat Google die Google Home Mobile SDK. Die Mobile SDK enthält zwei Kern-APIs, mit denen deine Apps Folgendes können: Geräte mit dem Google-Netzwerk in Betrieb nehmen und gemeinsam nutzen.

Sobald ein Gerät dem Google-Fabric hinzugefügt wurde, können Nutzer über Google Home app (GHA), Ein/Aus-Taste von Android, Sprachsteuerung und Touchscreen-Geräte von Nest.

Mit Mobile SDK können Sie auch einen kundenspezifischer Inbetriebnahmeservice mit dem Sie Geräte für zusätzliche Matter in Betrieb nehmen können Ökosystemen.

Mobile SDK in Ihre Android-App einbinden

Führen Sie zunächst die folgenden Schritte aus:

  1. Folgen Sie dazu der Anleitung unter Richten Sie Google Play services ein.

  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 und daher Die Funktion Matter ist nur auf dem Gerät verwenden, wenn eine App auf dem Gerät die geeigneten Modulabhängigkeit Play services in der zugehörigen Datei AndroidManifest.xml.

Das GHA und das Google Home Sample App for Matter enthalten beide Folgendes: Modulabhängigkeit in ihrem Manifest. Wenn Sie das Mobile SDK in Ihre Android App ein, um sicherzustellen, Matter-Unterstützung für Nutzer deiner App, füge die nach service-Block zur application-Deklaration in Ihrem AndroidManifest.xml-Datei:

<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 ausgeführte Geräte unterstützt Play services 22.50.14 oder höher.

Sieh dir die Sample App for Matter an Manifest finden Sie eine Beispielimplementierung.

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

Andere Android-Apps anrufen

Wenn du Android 11 oder höher verwendest, musst du Folgendes angeben: queries-Block in AndroidManifest.xml, damit deine App Aufrufe senden kann an anderen Apps.

<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 in der Artikel zum Filtern der Paketsichtbarkeit für Android-Geräte

Google Home-Beispiel-App für Matter verwenden

Wenn du wissen möchtest, wie Mobile SDK in einer Android-App funktioniert, versuche Sample App for Matter.

<ph type="x-smartling-placeholder"></ph> Sample App for Matter ausprobieren

Eigene App erstellen

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

<ph type="x-smartling-placeholder"></ph> Zum Codelab zu 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 bei Home Mobile SDK.