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 będzie komputer z zainstalowanymi tymi narzędziami:

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

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Można to zrobić za pomocą menedżera pakietu SDK.

Aby przetestować interfejsy Home API, musisz mieć:

  • Urządzenie z Androidem 10 lub nowszym skonfigurowane za pomocą konta Google, którego zamierzasz używać do tworzenia aplikacji. Sprawdź, czy masz zainstalowaną aktualną wersję Android Studio i czy jest ona zalogowana na to konto dewelopera.
  • sieć Wi-Fi;
  • Aby uzyskać dostęp do urządzeń Matter i nimi sterować, potrzebujesz też centrali Google obsługującej interfejsy Home API. Więcej informacji znajdziesz w artykule Łączność na Androidzie .

  • W domu musi być co najmniej 1 obsługiwane urządzenie. Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z technologii Thread, hub musi być też Thread Border Router (TBR). Aplikacja przykładowa 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)
    • Ściemniane światło (włączanie i wyłączanie, jasność)
    • Zamek drzwi
    • Rozszerzone światło kolorowe (włączanie i wyłączanie, jasność)
    • Przełącznik ogólny
    • Router graniczny Google
    • Aparat Google
    • Google Doorbell
    • Czujnik obecności (wykrywanie obecności)
    • Włączanie i wyłączanie światła (włączanie i wyłączanie, jasność)
    • Włącznik światła
    • Urządzenie włączane/wyłączane (włączanie i wyłączanie)
    • Czujnik włączania/wyłączania

Obsługiwane huby

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

Tabela: urządzenia Google Nest Hub obsługujące interfejsy 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 ramach otwartych testów 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 SDK Home API na Androida, musisz najpierw zalogować się w Google Home Developers.

Zaloguj się

Dalej
2. Set up OAuth