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:
Postępuj zgodnie z instrukcjami podanymi w sekcji 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'
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
.
GHA i Google 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 Android z 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 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.