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, wersja 2024.2.1 („Ladybug”) lub nowsza. Pamiętaj, że starsze wersje mogą nie działać prawidłowo z pakietem SDK interfejsów Home API.

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Możesz to zrobić za pomocą SDK Managera.

Aby przetestować interfejsy Home API, musisz mieć:

  • urządzenie z Androidem 10 lub nowszym skonfigurowane z kontem Google, którego chcesz używać do programowania; Upewnij się, że na urządzeniu jest zainstalowana aktualna wersja aplikacji Android Studio i że jesteś zalogowany(-a) na to konto dewelopera.
  • sieć Wi-Fi,
  • Aby uzyskać dostęp do urządzeń Matter i nimi sterować, musisz też mieć urządzenie Google, które obsługuje interfejsy Home API. Więcej informacji znajdziesz w artykule Połączenia na Androidzie .

  • co najmniej 1 obsługiwane urządzenie w domu, Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z Thread, koncentrator musi być również Thread Border Router (TBR). Przykładowa aplikacja na Androida obsługuje te typy urządzeń i cechy:

    • Światło o regulowanej temperaturze kolorów (włączanie i wyłączanie, jasność)
    • Czujnik kontaktowy (stan logiczny)
    • Światło z możliwością przyciemniania (włączanie i wyłączanie, jasność)
    • Zamek drzwi
    • Extended Color Light (włączanie i wyłączanie, jasność)
    • Przełącznik ogólny
    • Router graniczny Google
    • Aparat Google
    • Google Doorbell
    • Czujnik obecności (wykrywanie obecności)
    • Światło (włączanie i wyłączanie, jasność)
    • Włącznik/wyłącznik światła
    • Wtyczka z przełącznikiem (włączanie i wyłączanie)
    • Czujnik włączania/wyłączania

Obsługiwane centra

Tylko niektóre urządzenia Google Nest Hub obsługują interfejsy Home API.

Tabela: urządzenia Google Nest Hub z obsługą interfejsów Home API
Urządzenie Obsługa routera granicznego 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 dla deweloperów na potrzeby programowania. Aby tworzyć aplikacje za pomocą interfejsów Home API, musisz pobrać biblioteki i hostować je lokalnie.

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

Zaloguj się teraz

Dalej
2. Set up OAuth