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.

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.

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”.

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.

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
• Wybierz projekt w chmurze

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ę.

   

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.

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.

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 cached na końcu zapytania.

Po przesłaniu co najmniej 1 zapytania kliknij cached 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.

Kliknij save 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 tocZbieraj, narzędzie Assistant Simulator uruchomi zapytania. Powiadomimy Cię, gdy zostanie zarejestrowana nowa odpowiedź, a na pasku Stan wyświetli się licznik przetwarzania zapytań.

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

{
  "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 switch_left 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:

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

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 check.

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.

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:

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

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 datycalendar_month, a potem wpisać godzinę w polu tekstowym.

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

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 cached Pobierz, aby przesłać parametry zapytania.

Po wczytaniu logów kliknij dowolny rekord chevron_right, aby rozwinąć pełny ładunek JSON. Kliknij jeszcze raz chevron_left, 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 wykres domowy i przeprowadź testy

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

Kliknij cached 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 chevron_right, aby rozwinąć pełny ładunek JSON.

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

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.

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

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ę clear.

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 arrow_downward) oraz Znajdź poprzednie (ikona arrow_upward).
• 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

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ę.