Dodawanie interfejsów API Home do aplikacji na Androida

Aby dodać interfejsy Home API do aplikacji na Androida, musisz spełnić kilka wymagań wstępnych.

Wymagania wstępne

Do programowania potrzebny jest komputer z zainstalowanymi tymi narzędziami:

  • Android Studio w wersji 2024.2.1 ("Ladybug") lub nowszej. Pamiętaj, że wersje wcześniejsze mogą nie działać prawidłowo z pakietem Home APIs SDK.

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Możesz to zrobić za pomocą Menedżera SDK.

Aby testować interfejsy Home API, potrzebujesz:

  • Urządzenie z Androidem 10 lub nowszym skonfigurowane za pomocą konta Google, którego chcesz używać do programowania. Upewnij się, że masz zainstalowaną aktualną wersję Android Studio i że jesteś zalogowany na to konto dewelopera.
  • Sieć Wi-Fi.
  • Aby uzyskiwać dostęp do urządzeń Matter i nimi sterować, potrzebujesz też huba Google, który obsługuje interfejsy Home API. Więcej informacji znajdziesz w artykule Łączność na Androidzie .

  • Co najmniej 1 obsługiwane urządzenie w domu. Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z protokołu Thread, hub musi być też routerem granicznym Thread. Przykładowa aplikacja na Androida obsługuje te typy urządzeń i cechy:

    • Światło o regulowanej temperaturze barwowej (włączanie i wyłączanie, jasność)
    • Czujnik kontaktu (stan logiczny)
    • Światło z możliwością ściemniania (włączanie i wyłączanie, jasność)
    • Światło o rozszerzonej palecie barw (włączanie i wyłączanie, jasność)
    • Ogólny przełącznik
    • Aparat Google
    • Czujnik obecności (wykrywanie obecności)
    • Światło z włącznikiem (włączanie i wyłączanie, jasność)
    • Przełącznik światła
    • Gniazdko z włącznikiem (włączanie i wyłączanie)
    • Czujnik z włącznikiem

Obsługiwane huby

Tylko niektóre huby Google Nest obsługują interfejsy Home API.

Tabela: huby Google Nest obsługujące interfejsy Home API
Urządzenie Obsługa routera brzegowego Thread Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

Konfigurowanie pakietu SDK

Interfejsy Home API w tej otwartej wersji beta nie są jeszcze częścią standardowych bibliotek udostępnianych przez Google na potrzeby programowania. Aby tworzyć aplikacje za pomocą interfejsów Home API, musisz pobrać i hostować biblioteki lokalnie.

Aby pobrać pakiet Home APIs Android SDK, musisz najpierw zalogować się w Google Home Developers.

Zaloguj się teraz

Dalej
2. Set up OAuth