Wtyczka Google Home do Androida Studio

Aplikacja Google Home Plugin for Android Studio została zaprojektowana z myślą o deweloperach Google Home Platform. Ta wtyczka zapewnia dostęp do Google Assistant Simulator, Cloud Logging i innych narzędzi, które upraszczają proces inteligentnego tworzenia domu.

Wtyczka Google Home do Androida Studio

Informacja o zabezpieczeniach

Aby zapobiec przechowywaniu obiektów tajnych i haseł przez Android Studio, wykonaj te czynności:

  1. Kliknij Plik, a następnie Ustawienia...
  2. W sekcji Wygląd i działanie rozwiń Ustawienia systemu, a następnie kliknij Hasła.
  3. Wybierz Nie zapisuj, nie zapomnij hasła po ponownym uruchomieniu.
Wtyczka Google Home do Androida Studio

Funkcje

Symulator Asystenta

Aby sprawdzić, czy inteligentne urządzenia domowe współpracują z ekosystemem Google Home, możesz w każdej chwili wejść w interakcję z urządzeniem Assistant Simulator bez opuszczania Android Studio.

Podobnie jak istniejący symulator Asystenta, który znajdziesz w konsoli Actions on Google Console, Assistant Simulator ułatwia sterowanie urządzeniami, wpisując zapytania, na przykład „Włącz światło”. Wewnątrz Android Studio użytkownik Assistant Simulator odpowiada na SMS-y na podstawie Twoich poleceń, na przykład „Rozumiem, włączam światło”.

Testowanie za pomocą symulatora Asystenta

Wyświetl Cloud Logging

Google Cloud Logging zapewnia informacje debugowania i kluczowe dane, które dają wgląd w wykorzystanie akcji. Aby uprościć programowanie, podczas rozwiązywania problemów Google Home Plugin wyświetla obok komunikatów kod Cloud Logging.

Możesz wyświetlać dzienniki w czasie rzeczywistym lub wybrać zakres dat.

Widok Cloud Logging

Wystąpienia zbiorcze

Assistant Simulator odpowiedzi na jedną wypowiedź nie są ostateczne. Odpowiedź może być na przykład taka:

  • OK, włączam dwa światła.
  • Jasne, włączam dwa światła.
  • OK, włączam dwa światła.
  • OK, włączam dwa światła.

Aby uruchomić automatyczne testy i sprawdzić, jak integracje Google współpracują z tymi różnymi odpowiedziami, możesz wysyłać wiadomości zbiorcze do Assistant Simulator, uruchamiając skrypty komunikatów. Po zapisaniu skryptu możesz zbierać odpowiedzi i uruchamiać wiele testów dotyczących zapytań.

Wyświetlający Home Graph

Przeglądarka Home Graph umożliwia wyświetlanie stanu urządzeń i uruchamianie Google Home Test Suite w przeglądarce.

Wyświetlający dzienniki Android Debug Bridge (adb)

Przeglądarka logów Adb to narzędzie do wyświetlania i analizowania plików dziennika, na przykład Matter plików dziennika urządzenia, dzienników Google Home czy dzienników Androida.

Zainstaluj

Aby zainstalować Google Home Plugin w Android Studio, wykonaj te czynności:

  1. Pobierz lub zaktualizuj aplikację Android Studio. Pobierz Android Studio
  2. W systemie MacOS kliknij Plik > Ustawienia (Android Studio > Ustawienia).
  3. W sekcji Wtyczki otwórz Marketplace i wyszukaj google home.
  4. Zainstaluj narzędzie i uruchom ponownie Android Studio.

Możesz też pobrać wtyczkę bezpośrednio z JetBrains Marketplace.

Konfiguracja

Po zainstalowaniu wtyczki musisz wykonać te czynności, aby móc używać Assistant Simulator i wyświetlać Cloud Logging:

Zaloguj się przez Google

W panelu Google Home możesz zalogować się na swoje konto dewelopera, by upoważnić firmę Android Studio do komunikowania się z usługami Google w Twoim imieniu.

  1. Kliknij kartę Google Home w kolumnie kart pionowych po lewej stronie okna Android Studio.

  2. W polu Zaloguj się przez kliknij Google, aby otworzyć przeglądarkę.

    Logowanie przez Google Studio w Android Studio
  3. Wybierz konto połączone z inteligentnymi urządzeniami domowymi.

  4. Na stronie autoryzacji Zaloguj się przez Google kliknij Zezwól.

  5. Zamknij okno przeglądarki i wróć do Android Studio.

Powinno Ci się już udać zalogować z opcją Wyloguj się.

Wybierz projekt Cloud

Po zalogowaniu się wybierz z menu Projekt. Aby przefiltrować listę projektów, wpisz wyrażenie Filtr, na przykład matter, a następnie naciśnij Enter.

Menu Projekt wczytuje pierwsze 100 projektów na podstawie Twojego filtra. Wybrane wartości zostaną zachowane, gdy opuścisz: Android Studio.

Wybierz projekt

Więcej informacji o filtrach projektów znajdziesz w artykule Parametry zapytania w dokumentacji Google Cloud.

Użyj symulatora Asystenta

Aby otworzyć Assistant Simulator w Android Studio, kliknij Panel wypowiedzi w panelu Google Home Plugin.

Otwórz panel wypowiedzi

Zapytania można wysyłać do Assistant Simulator na kilka sposobów. Teraz omówię każdą z opcji.

Wpisywanie zapytań i zbieranie odpowiedzi

Aby wejść w interakcję z elementem Assistant Simulator, wpisz zapytanie i naciśnij Enter.

Możesz ponownie wysłać zapytanie, klikając ikonę ponownego wysyłania na końcu zapytania.

Po przesłaniu co najmniej 1 zapytania kliknij Odtwórz ponownie, aby ponownie uruchomić zapytania i sprawdzić odpowiedzi. Panel Wyrażenia pozwala śledzić zapytania i odpowiedzi w przechowywanej pamięci podręcznej. Ponowne odtwarzanie dodaje tylko te odpowiedzi do wewnętrznej pamięci podręcznej. Nie powoduje duplikowania zapytań za każdym razem, gdy klikniesz przycisk.

Odtwarzaj ponownie wyrażenia za pomocą symulatora Asystenta

Kliknij Zapisz, aby zapisać zapytania i odpowiedzi podane w panelu Wyrażenia. Twoje interakcje są konwertowane do formatu JSON w tym formacie:

  • ask: zapytanie.
  • answers: tablica możliwych odpowiedzi Assistant Simulator.

Ten plik JSON możesz edytować w aplikacji Android Studio.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

Zbieranie odpowiedzi zbiorczych

W panelu Google Home Plugin kliknij Plik wypowiedzi, aby otworzyć w nowej karcie zapisane pliki JSON. W polu Wybierz ścieżkę możesz wybrać plik lub folder. Jeśli wybierzesz folder, opcje Zbieraj i Test będą działać na wszystkich plikach wypowiedzi .json w tym folderze.

Możesz otworzyć wiele kart tego samego pliku lub różnych plików, np. lights, lights(1) i plug.

Na pasku stanu wyświetlany jest wynik ostatniego testu (jeśli dotyczy), żółta lub zielona kropka wskazująca, że plik został zebrany, oraz ścieżka pliku wypowiedzi (.json). Gdy klikniesz Zbieraj, narzędzie Assistant Simulator uruchomi zapytania. Powiadomimy Cię, gdy zostanie zarejestrowana nowa odpowiedź, a na pasku Stan wyświetli się licznik przetwarzania zapytań.

Zbieraj wyrażenia za pomocą symulatora Asystenta

Po zakończeniu gromadzenia na pasku stanu pojawi się zielony znacznik przed ścieżką .json, a pliki komunikatów zostaną wypełnione potencjalnymi odpowiedziami.

Zbieraj wyrażenia za pomocą symulatora Asystenta
{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

Jeśli zatrzymasz kolekcję wcześniej, ścieżka .json nie zostanie oznaczona jako zebrana.

Testowanie wyrażeń zbiorczych

Po zebraniu odpowiedzi kliknij Test, aby odtworzyć zapytania ponownie i sprawdzić odpowiedzi i logi. Podczas testowania wyrażeń zbiorczych Assistant Simulator oczekuje odpowiedzi zapisanych w pliku JSON. Jeśli test zwróci odpowiedź, która nie została zebrana, otrzymasz powiadomienie podobne do tej:

Expected one of: "Got it, turning on 2 lights."

Uruchamianie wyrażeń za pomocą symulatora Asystenta

Ten scenariusz wskazuje na niepowodzenie testu. W przeciwnym razie Assistant Simulator będzie uruchamiać każde z Twoich zapytań i zwracać odpowiedź. Jeśli test się powiedzie, na pasku stanu pojawi się ikona .

Uruchamianie wyrażeń za pomocą symulatora Asystenta

Wyświetl Cloud Logging

Aby otworzyć kartę projektu w oknie narzędzia Cloud Logs, kliknij Cloud Logs w panelu Google Home Plugin. Możesz otworzyć osobne karty Cloud Logging dla każdego projektu.

Karty Cloud Logging

Wyszukiwane hasła

W wybranym projekcie możesz też filtrować logi, korzystając z pola Zapytanie. Aby na przykład odfiltrować logi słowa kluczowego light:

Zapytanie Cloud Logging

Wybierz Użyj QL, aby użyć języka zapytań dotyczących logowania.

Język zapytań Cloud Logging

Oto kilka przykładów zapytań kontroli jakości, które pomogą Ci zacząć:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

Zapytania dotyczące daty i godziny

Wykonywanie zapytań dotyczących logów według daty jest opcjonalne i można je włączyć, klikając Po i Przed. W polu tekstowym możesz wpisać format daty i godziny, np. 5/11/22, 12:37 PM. Możesz też wybrać daty za pomocą selektora daty, a potem wpisać godzinę w polu tekstowym.

  • Aby wybrać datę po 5/1/22, kliknij Po i kliknij ikonę daty .
  • Aby wybrać datę wcześniejszą niż 5/1/22, kliknij Przed i kliknij ikonę daty .
  • Aby wybrać datę między 5/1/22 a 6/30/22, kliknij Przed i Po, a potem wybierz daty z ikony daty .

Wybierz Czas rzeczywisty, aby pobrać aktywne dzienniki projektu. Kliknij Zatrzymaj, aby zakończyć przesyłanie pliku w czasie rzeczywistym.

Poziom ważności

Możesz też wybrać Małą wagę z menu.

Wyniki zapytania

Kliknij Pobierz, aby przesłać parametry zapytania.

Po wczytaniu logów kliknij dowolny rekord , aby rozwinąć pełny ładunek JSON. Kliknij jeszcze raz , aby wyświetlić całą wiadomość.

Opcjonalnie w polu Filtr możesz wpisać słowo kluczowe, aby zawęzić wyniki logu. Kliknij x, aby usunąć filtr i wrócić do pierwotnych wyników pobierania.

Wyświetl Cloud Logging

Wyświetl wykres domowy i przeprowadź testy

Aby zobaczyć listę swoich urządzeń, wybierz Wykres główny w panelu Google Home Plugin.

Kliknij Odśwież, aby wyświetlić Nazwę urządzenia, Identyfikator urządzenia i Typ urządzenia urządzeń powiązanych z wybranym projektem. Możesz otworzyć wiele paneli Google Home Graph dla różnych projektów.

Po załadowaniu urządzeń kliknij dowolny rekord , aby rozwinąć pełny ładunek JSON.

Ładunek JSON wykresu Home

Możesz też używać funkcji Rozwiń i Zwiń, aby wyświetlać i ukrywać ładunki JSON na swoich urządzeniach.

Rozwiń i zwiń JSON z wykresem głównym

Aby uruchomić pakiet testów na konkretnym urządzeniu, kliknij Przetestuj. Spowoduje to uruchomienie w przeglądarce pakietu testowego z wybranym urządzeniem i testowaniem. Kliknij Rozpocznij i zaczekaj na wyniki testu.

Testy uruchomienia Home Graph

Możesz sprawdzić szczegóły testu i wyświetlić logi po ich zakończeniu.

Ukończone testy grafu strony głównej

Wyświetlający dzienniki Android Debug Bridge (adb)

Aby otworzyć kartę projektu w oknie narzędzia Administracja, kliknij polecenie Log Adb na pasku narzędzi wtyczki Google Home (po lewej stronie). Dla każdego pliku dziennika możesz otworzyć osobną kartę Log adb. Aby usunąć kartę, kliknij ikonę .

W polu Wybierz wybierz konkretny komponent logowania, który chcesz wyświetlić, oraz w menu Poziom ważności, aby wyświetlić tylko wpisy o pasującej wadze logu.

W przypadku wybranego dziennika adb możesz filtrować wpisy logu za pomocą pola Filtr z opcjonalnymi modyfikatorami wielkość liter lub wyrażenia regularne.

Dodatkowo możesz:

  • Aby znaleźć określone wpisy, użyj pól Znajdź oraz Znajdź następne (ikona ) oraz Znajdź poprzednie (ikona ).
  • Użyj opcjonalnych modyfikatorów rozróżniania wielkości liter lub wyrażenia regularnego.
  • Przejdź do wiersza, aby przejść do określonego wiersza (według numeru) w dzienniku

Wybierz Numerowane, aby wyświetlić wiersze dziennika z dodanymi numerami. Wybierz Nieprzetworzony, aby wyświetlić nieprzetworzone wpisy logu

Wyświetlający log ADB

Zasoby i opinie

Aby wyświetlić listę narzędzi i zasobów dla programistów, kliknij Zasoby.

Aby podzielić się swoimi uwagami lub uwagami na temat tego, jak możemy ulepszyć środowisko Google Home Plugin, kliknij Prześlij opinię.

Prześlij opinię