Aplikacja przykładowa interfejsów API Home na Androida

Przykładowa aplikacja demonstruje podstawowe możliwości interfejsów API Google Home.

Wymagania wstępne

Aby utworzyć, zainstalować i przetestować aplikację, musisz spełnić kilka wymagań wstępnych:

  • Android Studio, wersja 2024.2.1 („Ladybug”) lub nowsza. Pamiętaj, że starsze wersje mogą nie działać prawidłowo z Home APIs SDK.

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

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

Aby przetestować interfejsy API Home, musisz mieć:

  • Urządzenie z Androidem 10 lub nowszym, na którym skonfigurowano konto Google, którego zamierzasz używać do tworzenia aplikacji. Sprawdź, czy zainstalowana jest aktualna wersja aplikacji Android Studio i czy zalogowano się na to konto deweloperskie.
  • sieć Wi-Fi,
  • Centrum Google, które obsługuje interfejsy API Home.

  • 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 też być routerem brzegowym Thread. Przykładowa aplikacja na Androida obsługuje te typy i traits urządzeń:

    • Temperatura barw światła (włączanie i wyłączanie, jasność)
    • Czujnik kontaktowy (wartość logiczna)
    • Regulowane światło (włączanie i wyłączanie, jasność)
    • Extended Color Light (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 On/Off
    • Włącznik (włączanie i wyłączanie)
    • Czujnik włączania i wyłączania

  1. W konsoli Google Cloud otwórz panel wyboru projektu i wybierz projekt, którego chcesz użyć do utworzenia danych uwierzytelniających OAuth.
  2. Otwórz stronę Interfejsy API i usługi, a potem w menu nawigacyjnym kliknij Dane logowania.

  3. Jeśli nie masz jeszcze skonfigurowanego ekranu zgody w tym projekcie Google Cloud, pojawi się przycisk Skonfiguruj ekran zgody. W takim przypadku skonfiguruj ekran zgody, wykonując te czynności. W przeciwnym razie przejdź do następnej sekcji.

    1. Kliknij Skonfiguruj ekran zgody. Wyświetla się strona Ekran zgody OAuth.
    2. W zależności od przypadku użycia wybierz Wewnętrzny lub Zewnętrzny, a następnie kliknij Utwórz. Pojawi się panel Ekran zgody OAuth.
    3. Wpisz informacje na stronie z informacjami o aplikacji zgodnie z instrukcjami wyświetlanymi na ekranie, a potem kliknij Zapisz i kontynuuj. Pojawi się panel Zakresy.
    4. Nie musisz dodawać żadnych zakresów, więc kliknij Zapisz i kontynuuj. Wyświetli się panel Testowi użytkownicy.
    5. Jeśli chcesz dodać użytkowników, którzy będą testować dostęp do aplikacji, kliknij Dodaj użytkowników. Pojawi się panel Dodaj użytkowników. Użytkownicy testowi mają uprawnienia do przyznawania uprawnień w aplikacji.
    6. W pustym polu dodaj co najmniej 1 adres e-mail konta Google, a następnie kliknij Dodaj.
    7. Kliknij Zapisz i kontynuuj. Pojawi się panel Podsumowanie.
    8. Zapoznaj się z informacjami na ekranie zgody OAuth, a potem kliknij Wróć do panelu.

Więcej informacji znajdziesz w artykule Konfigurowanie ekranu zgody OAuth w Centrum pomocy konsoli Google Cloud.

Pobieranie kodu źródłowego

Kod źródłowy przykładowej aplikacji jest dostępny na GitHubie.

Przejdź do miejsca, w którym chcesz zapisać projekt, a potem go sklonuj:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

Konfigurowanie pakietu SDK

Interfejsy API Home w ramach otwartych testów beta nie są jeszcze częścią standardowych bibliotek udostępnianych przez Google do programowania. Aby tworzyć aplikacje z użyciem interfejsów API Home, musisz pobrać biblioteki i hostować je lokalnie.

Aby pobrać pakiet Android SDK interfejsów API Home, musisz najpierw zalogować się w Google jako deweloper Home.

Zaloguj się teraz

Tworzenie i uruchamianie

  1. Otwórz Android Studio, a potem folder projektu google-home-api-sample-app-android, który został sklonowany na komputer lokalny.
  2. Podczas pierwszej konfiguracji Android Studio może minąć do 10 minut, zanim zostaną pobrane wszystkie zależności projektu i ukończone kompilowanie Gradle.
    • Jeśli podczas tego kroku pojawi się błąd, np. Gradle Sync Failed, kliknij Spróbuj ponownie, aby rozpocząć synchronizację od nowa.
  3. Zmień nazwę pakietu przykładowej aplikacji na nową, która nie była wcześniej zarejestrowana, np. na nazwę organizacji:
    1. Otwórz projekt.
    2. Rozwiń hierarchię źródeł.
    3. Wybierz część pakietu, którą chcesz zmienić, czyli com.example.
    4. Kliknij pakiet prawym przyciskiem myszy i wybierz Refactor > Zmień nazwę.
    5. Kliknij Wszystkie katalogi.
    6. Wpisz nową nazwę i kliknij Refactor (Refaktoryzacja).
    7. Edytuj plik build.gradle.kts, zmieniając android namespace i applicationId na nową nazwę pakietu.
    8. Edytuj plik AndroidManifest.xml i zmieniaj nazwę pakietu na nową, wszędzie tam, gdzie występuje w pliku.

  4. Wygeneruj certyfikat podpisywania aplikacji debugującej, uruchamiając aplikację w trybie Android Studio. Gdy uruchamiasz aplikację lub debugujesz ją w Android Studio, Android Studio automatycznie generuje certyfikat podpisywania aplikacji przeznaczony do tworzenia i debugowania. Pełne wyjaśnienia znajdziesz w artykule Android Studio: podpisywanie wersji debugowej.

    Połącz urządzenie mobilne z komputerem lokalnym. Android Studio wyświetli listę połączonych urządzeń według numeru modelu. Wybierz urządzenie z listy, a potem kliknij Uruchom projekt. Spowoduje to wygenerowanie i zainstalowanie przykładowej aplikacji na urządzeniu mobilnym.

    Więcej szczegółowych instrukcji znajdziesz w artykule Uruchamianie aplikacji na urządzeniu z Androidem na stronie dla deweloperów aplikacji na Androida.

    Zatrzymaj uruchomioną aplikację.

  5. Aby uzyskać odcisk cyfrowy SHA-1 certyfikatu debugowania, wykonaj instrukcje podane w artykule Konfigurowanie OAuth 2.0 / Aplikacje natywne / Android w Centrum pomocy konsoli Google Cloud.

  6. Zarejestruj przykładową aplikację do OAuth 2.0 i utwórz dane logowania OAuth, wykonując instrukcje podane w artykule Konfigurowanie OAuth 2.0.

    1. Wskazać typ aplikacji, czyli natywna aplikacja na Androida.
    2. Dodaj odcisk cyfrowy SHA-1 do klienta OAuth, wykonując instrukcje w artykule Konfigurowanie OAuth 2.0 / Aplikacje natywne / Android w Centrum pomocy Google Cloud Console. Podczas procesu tworzenia wygeneruj klucz SHA-1 z domyślnego klucza Androida Studio.
    3. Dodaj użytkowników testowych. Użytkownicy testowi mają uprawnienia do przyznawania uprawnień w próbnej aplikacji.

  7. Po podłączeniu urządzenia mobilnego do komputera lokalnego kliknij Uruchom projekt, aby uruchomić przykładową aplikację na urządzeniu mobilnym.

Po zainstalowaniu aplikacja będzie dostępna na urządzeniu mobilnym jako próbna aplikacja interfejsu Home API.