Aby ułatwić tworzenie aplikacji na Androida, które współdziałają z Matter, firma Google opracowała Google Home Mobile SDK Mobile SDK obejmuje 2 podstawowe interfejsy API, które umożliwiają aplikacjom udostępniać urządzenia w sieci szkieletowej Google i udostępniać je.
Po dodaniu urządzenia do tkaniny Google użytkownicy mogą kontrolować urządzeń z Google Home app (GHA), sterowaniem zasilaniem Androida, głosem, i urządzenia z ekranem dotykowym Nest.
Mobile SDK umożliwia również zdefiniowanie usługi niestandardowe które możesz wykorzystać, aby zlecić urządzenia dodatkowe Matter ekosystemu.
Zintegruj pakiet SDK do urządzeń mobilnych z aplikacją na Androida
Aby rozpocząć, wykonaj następujące czynności:
Postępuj zgodnie z instrukcjami podanymi na stronie Skonfiguruj usługę Google Play services.
Dodaj zależność Play services do pliku
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Zadbaj o dostarczanie modułów
Moduł home w usłudze Play services jest opcjonalny, więc
Funkcja Matter będzie dostępna tylko w
urządzenia, jeśli aplikacja na urządzeniu określa odpowiednią
zależność modułu Play services w pliku AndroidManifest.xml.
GHA i Google Home Sample App for Matter zawierają to
zależności modułów w pliku manifestu. Jeśli integrujesz
Mobile SDK do aplikacji Android, aby upewnić się,
pomocy na poziomie Matter dla użytkowników aplikacji, dodaj parametr
po bloku service do deklaracji application w Twoim
Plik 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 Android urządzeniach z Play services w wersji 22.50.14 lub nowszej.
Zobacz Sample App for Matter plik manifestu .
Dostępność modułu strony głównej możesz sprawdzić w czasie jego działania, używając:
ModuleInstallClient Zobacz
Zapewnianie dostępności interfejsu API za pomocą ModuleInstallClient
.
Nawiązywanie połączeń z innymi aplikacjami na Androida
Jeśli używasz Androida 11 lub nowszego, musisz dodać te informacje:
Blokada queries w AndroidManifest.xml, aby Twoja aplikacja mogła dzwonić pod te numery:
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: Artykuł na temat filtrowania widoczności pakietów na urządzeniach z Androidem.
Używaj przykładowej aplikacji Google Home w przypadku standardu 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
Utwórz własną aplikację
Aby pomóc Ci szybko wykonać pierwsze kroki, udostępniliśmy Sample App for Matter udostępnia dodatkowe ćwiczenia z programowania, dostosować nasz przykładowy kod do własnych projektów na Androida.
Otwórz ćwiczenia z programowania dotyczące: Sample App for Matter
Zasoby
Więcej informacji o Mobile SDK znajdziesz tutaj Dokumentacja API.
Informacje o tym, jak ten pakiet SDK postępuje z danymi użytkowników, znajdziesz w sekcji na temat bezpieczeństwa danych w pakiecie SDK na urządzenia mobilne z Google Play.