Google Home Mobile SDK na Androida

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

Gdy urządzenie zostanie dodane do Google Fabric, użytkownicy będą mogli nim sterować za pomocą Google Home app (GHA), funkcji sterowania zasilaniem w Androidzie, głosu oraz urządzeń z ekranem dotykowym Nest.

Mobile SDK umożliwia też zdefiniowanie niestandardowej usługi aktywacji, która może służyć do aktywacji urządzeń w dodatkowych ekosystemach Matter.

Integracja pakietu SDK do reklam mobilnych z aplikacją na Androida

Aby rozpocząć, wykonaj te czynności:

  1. Postępuj zgodnie z instrukcjami podanymi w sekcji 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'
    

Zapewnienie dostarczenia modułu

Moduł Play services home jest opcjonalny, więc funkcja Matter będzie dostępna na urządzeniu użytkownika tylko wtedy, gdy aplikacja na urządzeniu określi odpowiednią zależność od modułu Play services w pliku AndroidManifest.xml.

GHAGoogle Home Sample App for Matter zawierają tę zależność w pliku manifestu. Jeśli integrujesz interfejs Mobile SDK z aplikacją Android, aby zapewnić użytkownikom aplikacji Matter obsługę interfejsu application, dodaj do pliku AndroidManifest.xml ten blok kodu service:

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

Ta funkcja jest obsługiwana tylko na urządzeniach AndroidPlay services w wersji 22.50.14 lub nowszej.

Przykład implementacji znajdziesz w pliku manifestu Sample App for Matter.

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

Nawiązywanie połączeń z innych aplikacji na Androida

Jeśli używasz Androida 11 lub nowszego, musisz umieścić w bloku AndroidManifest.xml ten blok queries, 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, zapoznaj się z artykułem Sample App for Matter.

Wypróbuj Sample App for Matter

Tworzenie własnej aplikacji

Aby ułatwić Ci rozpoczęcie pracy, udostępniliśmy kod Sample App for Matter w formie open source i dodaliśmy towarzyszące mu laboratorium kodu, które pozwoli Ci dostosować przykładowy kod do własnych projektów na Androida.

Otwórz Codelab 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, zapoznaj się z sekcją Bezpieczeństwo danych w Google Play dotyczącą pakietu Home Mobile SDK.