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ń w ramach 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 na stronie 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 dostawy 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.
Aplikacje GHA i Google Home Sample App for Matter zawierają tę zależność od modułu w swoim pliku manifestu. Jeśli chcesz zintegrować usługę Mobile SDK z aplikacją Android, dodaj do deklaracji application w pliku AndroidManifest.xml blok service, aby zapewnić użytkownikom aplikacji Matter obsługę tej usługi:
<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, używając 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 uwzględnić 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ący mu dokument Codelab, który 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 interfejsu 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.