Aby pomóc Ci w tworzeniu aplikacji na Androida, które współpracują z urządzeniami Matter, Google opracowało Google Home Mobile SDK. Mobile SDK zawiera 2 główne interfejsy API, które umożliwiają aplikacjom uruchamianie i udostępnianie urządzeń w sieci Google.
Po dodaniu urządzenia do sieci Google użytkownicy mogą nim sterować za pomocą Google Home app (GHA), elementów sterujących zasilaniem na urządzeniu z Androidem, 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 ekosystemów Matter.
Integrowanie pakietu Mobile SDK z aplikacją na Androida
Aby rozpocząć, wykonaj te czynności:
Postępuj zgodnie z instrukcjami podanymi w artykule Konfigurowanie Google Play services.
Dodaj zależność Play services do pliku
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Zapewnianie dostarczania modułów
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ść modułu Play services w pliku AndroidManifest.xml.
Zarówno GHA, jak i Google Home Sample App for Matter zawierają tę zależność modułu w swoich plikach manifestu. 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>
Ta funkcja jest obsługiwana tylko na urządzeniach Android z aplikacją Play 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, używając 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 uwzględnić blok queries w pliku AndroidManifest.xml, aby aplikacja mogła wykonywać połączenia z innymi aplikacjami.
<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 o filtrowaniu widoczności pakietów na Androidzie.
Korzystanie z przykładowej aplikacji Google Home na Matter
Aby dowiedzieć się, jak działa Mobile SDK w aplikacji na Androida, wypróbuj 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 Sample App for Matter jako open source i przygotowaliśmy ćwiczenie z programowania, dzięki któremu możesz dostosować nasz przykładowy kod do własnych projektów aplikacji na Androida.
Przejdź do ćwiczenia 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.