Aby pomóc Ci w tworzeniu aplikacji na Androida, które współdziałają z urządzeniami z systemem Matter, opracowaliśmy Google Home Mobile SDK. Mobile SDK zawiera 2 podstawowe interfejsy API, które umożliwiają aplikacjom uruchamianie i udostępnianie urządzeń za pomocą tkaniny Google.
Po dodaniu urządzenia do tkaniny Google użytkownicy mogą sterować swoimi urządzeniami za pomocą urządzeń z systemem Google Home app (GHA), elementów sterujących zasilaniem Androida, poleceń głosowych i ekranów dotykowych Nest.
Pole Mobile SDK pozwala też zdefiniować niestandardową usługę prowizji, której można używać do uruchamiania urządzeń w dodatkowych ekosystemach Matter.
Integracja pakietu SDK do aplikacji mobilnych z aplikacją na Androida
Aby rozpocząć, wykonaj te czynności:
Postępuj zgodnie z instrukcjami podanymi w artykule Konfiguracja 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, dlatego funkcja Matter będzie dostępna na urządzeniach użytkowników tylko wtedy, gdy aplikacja na urządzeniu wskaże w pliku AndroidManifest.xml odpowiednią zależność od modułu Play services.
GHA i Google Home Sample App for Matter zawierają w pliku manifestu zależność tego modułu. Jeśli integrujesz Mobile SDK z aplikacją Android, aby zapewnić użytkownikom Matter obsługę aplikacji, w pliku AndroidManifest.xml dodaj do deklaracji application ten blok 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>
To ustawienie jest obsługiwane tylko na urządzeniach z Android w wersji Play services 22.50.14 lub nowszej.
Przykład implementacji znajdziesz w pliku manifestu Sample App for Matter.
Dostępność modułu strony głównej możesz sprawdzić w czasie działania za pomocą ModuleInstallClient. Więcej informacji znajdziesz na stronie Uzyskiwanie dostępu do interfejsu API za pomocą ModuleInstallClient.
Nawiązywanie połączeń z innymi aplikacjami na Androida
Jeśli używasz Androida 11 lub nowszego, musisz uwzględnić ten blok queries w AndroidManifest.xml, aby Twoja aplikacja mogła nawiązywać 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.
Przykładowa aplikacja Matter z Google Home
Aby dowiedzieć się, jak Mobile SDK działa w aplikacji na Androida, przeczytaj nasz poradnik Sample App for Matter.
Wypróbuj Sample App for Matter
Utwórz własną aplikację
Aby pomóc Ci szybko rozpocząć korzystanie z tej usługi, udostępniliśmy na licencji open source interfejs Sample App for Matter. Przygotowaliśmy też ćwiczenie z programowaniem, które pozwala dostosować przykładowy kod do Twoich własnych projektów na Androida.
Przejdź do ćwiczeń z programowania Sample App for Matter
Zasoby
Więcej informacji o Mobile SDK znajdziesz w dokumentacji API.
Informacje o tym, jak ten pakiet SDK postępuje z danymi użytkownika, znajdziesz w sekcji na temat bezpieczeństwa danych mobilnych pakietu SDK Google Home