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 tworzenia aplikacji potrzebny będzie komputer z zainstalowanymi 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ż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 deweloperskie.
  • 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 1 obsługiwane urządzenie w domu. Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z Thread, hub musi być też 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)
    • Ściemniane światło (włączanie i wyłączanie, jasność)
    • Rozszerzone światło kolorowe (włączanie i wyłączanie, jasność)
    • Przełącznik ogólny
    • 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

Oprócz tych obsługiwanych hubów dostępny jest tryb bez huba, który oferuje ograniczone możliwości interfejsów Home API.

Konfigurowanie pakietu SDK

Interfejsy Home API w ramach tych 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 Home APIs Android SDK, musisz najpierw zalogować się w Google Home Developers.

Zaloguj się

Dalej
2. Set up OAuth