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 następującymi 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 interfejsów Home API.

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Możesz to zrobić za pomocą menedżera pakietów SDK.

Aby przetestować interfejsy API Home, będziesz potrzebować:

  • Urządzenie z Androidem 10 lub nowszym skonfigurowane za pomocą konta Google, którego zamierzasz używać do tworzenia aplikacji. Upewnij się, że zainstalowana jest aktualna wersja Android Studio i zaloguj się na konto programistyczne.
  • 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 urządzeniach z Androidem .

  • Co najmniej jedno obsługiwane urządzenie w domu. Jeśli to urządzenie (lub jakiekolwiek inne, które chcesz przetestować) wykorzystuje protokół Thread, koncentrator musi być również routerem granicznym Thread. Aplikacja przykładowa na Androida obsługuje te typy urządzeń i traits:

    • Ś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ść)
    • Rozszerzone światło kolorowe (włączanie i wyłączanie, jasność)
    • Generic Switch
    • Aparat Google
    • Czujnik obecności (wykrywanie obecności)
    • Włączanie i wyłączanie światła (włączanie i wyłączanie, jasność)
    • Włącznik światła
    • Włącznik/wyłącznik (włączony i wyłączony)
    • Czujnik włączania/wyłączania

Obsługiwane węzły

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 Thread Obsługa routera granicznego 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ę

Dalej
2. Set up OAuth