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 niż ta mogą nie działać prawidłowo z pakietem SDK interfejsów Home API.

    Pobieranie Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Możesz to zrobić za pomocą menedżera pakietów 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 jesteś zalogowany 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 Thread, hub musi być również routerem granicznym Thread. Przykładowa aplikacja 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ść)
    • Przełącznik ogólny
    • 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 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 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