Aby ułatwić Ci tworzenie aplikacji na Androida, które współpracują z Matterurządzeniami, Google opracowało Google Home Mobile SDK. Mobile SDKobejmuje 2 główne interfejsy API, które umożliwiają aplikacjom wdrażanie urządzeń i udostępnianie ich w sieci Google.
Gdy urządzenie zostanie dodane do sieci Google, użytkownicy będą mogli sterować nim za pomocą Google Home app (GHA), elementów sterujących zasilaniem na Androidzie, głosu i urządzeń z ekranem dotykowym Nest.
Mobile SDK umożliwia też zdefiniowanie niestandardowej usługi wdrażania, której możesz używać do wdrażania urządzeń w dodatkowych ekosystemach Matter.
Integrowanie pakietu SDK do reklam mobilnych 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 tym 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 mają w pliku manifestu zależność od tego modułu. Jeśli integrujesz Mobile SDK z aplikacją Android, aby zapewnić Matter obsługę 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 Androidem w wersji Play services 22.50.14 lub nowszej.
Przykład implementacji znajdziesz w Sample App for Matter.
Dostępność modułu Home możesz sprawdzić w czasie działania aplikacji za pomocą funkcji ModuleInstallClient. Więcej informacji znajdziesz na stronie Zapewnianie dostępności interfejsu API za pomocą interfejsu ModuleInstallClient.
Wywoływanie innych aplikacji na Androida
Jeśli używasz Androida 11 lub nowszego, musisz umieścić ten 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 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 programistyczne, dzięki czemu możesz dostosować nasz przykładowy kod do własnych projektów na Androida.
Otwórz Sample App for Matter codelab
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 SDK do urządzeń mobilnych Home.