Google Home Mobile SDK na Androida

Aby ułatwić Ci tworzenie aplikacji na Androida, które współpracują z Matter urządzeniami, Google opracowało Google Home Mobile SDK. Pakiet Mobile SDK Mobile SDK zawiera 2 podstawowe interfejsy API, które umożliwiają aplikacjom dodawanie urządzeń do sieci Google i udostępnianie ich.

Gdy urządzenie zostanie dodane do sieci Google, użytkownicy będą mogli sterować swoimi urządzeniami za pomocą Google Home app (GHA), elementów sterujących zasilaniem na Androidzie, głosu i urządzeń Nest z ekranem dotykowym.

Mobile SDK umożliwia też zdefiniowanie niestandardowej usługi dodawania , której możesz używać do dodawania urządzeń do dodatkowych Matter ekosystemów.

Integrowanie pakietu Mobile SDK z aplikacją na Androida

Aby zacząć, wykonaj te czynności:

  1. Postępuj zgodnie z instrukcjami podanymi w artykule Konfigurowanie Google Play services.

  2. Dodaj zależność Play services do pliku build.gradle:

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

Zapewnianie dostarczania modułu

Moduł Play services home jest opcjonalny, dlatego Matter funkcje będą dostępne na urządzeniu użytkownika tylko wtedy, gdy aplikacja na tym urządzeniu określi odpowiednią zależność od modułu Play services w pliku AndroidManifest.xml.

GHA i Google Home Sample App for Matter zawierają tę zależność od modułu w swoim manifeście. Jeśli integrujesz Mobile SDK z aplikacją Android, aby zapewnić obsługę Matter użytkownikom aplikacji, dodaj ten blok service do deklaracji application w pliku 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>

Jest to obsługiwane tylko na urządzeniach z Android z systemem Play services w wersji 22.50.14 lub nowszej.

Przykład implementacji znajdziesz w manifeście Sample App for Matter's.

Dostępność modułu Home możesz sprawdzić w czasie działania aplikacji za pomocą ModuleInstallClient. Więcej informacji znajdziesz na stronie Zapewnianie dostępności interfejsu API za pomocą ModuleInstallClient.

Wywoływanie innych aplikacji na Androida

Jeśli używasz Androida 11 lub nowszego, musisz dodać ten blok queries do pliku AndroidManifest.xml, aby aplikacja mogła wywoływać inne aplikacje.

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

Więcej informacji znajdziesz w artykule Filtrowanie widoczności pakietów na Androidzie.

Korzystanie z przykładowej aplikacji Google Home dla Matter

Aby dowiedzieć się, jak działa Mobile SDK w aplikacji na Androida, wypróbuj naszą Sample App for Matter.

Wypróbuj Sample App for Matter

Tworzenie własnej aplikacji

Aby ułatwić Ci szybkie rozpoczęcie pracy, udostępniliśmy kod źródłowy Sample App for Matter i powiązane z nim ćwiczenie z programowania. Dzięki temu możesz dostosować nasz przykładowy kod do swoich projektów na Androida.

Otwórz ćwiczenie z programowania dotyczące Sample App for Matter

Zasoby

Więcej informacji o Mobile SDK znajdziesz w dokumentacji API.

Aby dowiedzieć się, jak ten pakiet SDK obsługuje dane użytkowników, przeczytaj sekcję Bezpieczeństwo danych w Google Play w pakiecie Home Mobile SDK.