Google Home Plugin for Android Studio jest przeznaczony dla deweloperów platformy Google Home. Ta wtyczka zapewnia dostęp do Google Assistant Simulator, Cloud Logging i innych narzędzi, które upraszczają proces tworzenia inteligentnego domu.
Informacje dotyczące bezpieczeństwa
Aby uniemożliwić Android Studio przechowywanie tajemnic i haseł, wykonaj te czynności:
- Kliknij kolejno Plik i Ustawienia.
- W sekcji Wygląd i zachowanie rozwiń Ustawienia systemowe, a potem kliknij Hasła.
- Wybierz Nie zapisuj, zapomnij hasła po ponownym uruchomieniu.
Funkcje
Symulator Asystenta
Aby sprawdzić, czy urządzenia inteligentnego domu współpracują prawidłowo z ekosystemem Google Home, możesz w dowolnym momencie wchodzić w interakcje z Assistant Simulator bez wychodzenia z Android Studio.
Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, na przykład „Włącz światło”. W Android Studio Assistant Simulator odpowiada wiadomościami tekstowymi na podstawie Twoich poleceń, na przykład „Dobrze, włączam światło”.
Wyświetlanie Cloud Logging
Google Cloud Logging pokazuje informacje o debugowaniu i kluczowe dane, które ułatwiają analizowanie sposobu korzystania z Action. Aby uprościć proces tworzenia, podczas rozwiązywania problemów Google Home Plugin wyświetla w czasie rzeczywistym wiadomości Cloud Logging tuż obok kodu.
Możesz wyświetlić dzienniki w czasie rzeczywistym lub wybrać zakres dat.
Wyrażenia zbiorcze
Assistant Simulator odpowiedzi na pojedyncze wypowiedzi nie są deterministyczne. Odpowiedzią może być na przykład jedno z tych wyrażeń:
- Rozumiem, włączam 2 światła.
- Jasne, włączam 2 światła.
- OK, włączam 2 światła.
- Dobrze, włączam 2 światła.
Aby przeprowadzać testy automatyczne i sprawdzać, jak integracje Google działają z tymi różnymi odpowiedziami, możesz wysyłać zbiorcze wypowiedzi do usługi Assistant Simulator, uruchamiając skrypty wypowiedzi. Po zapisaniu skryptu możesz zbierać odpowiedzi i uruchamiać wiele testów dotyczących zapytań.
Wyświetlający panel Home Graph
Wyświetlarka Home Graph umożliwia wyświetlanie stanu urządzeń i uruchamianie pakietu testów Google Home w przeglądarce.
Przeglądarka logów Android Debug Bridge (adb)
Adb Log Viewer to narzędzie do wyświetlania i analizowania plików dziennika, na przykład Matterplików dziennika urządzenia, dzienników Google Home i dzienników Androida.
Zainstaluj
Aby zainstalować Google Home Plugin w Android Studio, wykonaj te czynności:
- Pobierz lub zaktualizuj aplikację Android Studio. Pobierz Android Studio
- Kliknij Plik > Ustawienia (Android Studio > Preferencje w MacOS).
- W sekcji Wtyczki kliknij Marketplace i wyszukaj
google home. - Zainstaluj narzędzie i uruchom ponownie Android Studio.
Możesz też pobrać wtyczkę bezpośrednio z platformy JetBrains Marketplace.
Konfiguracja
Po zainstalowaniu wtyczki musisz wykonać te czynności, aby móc korzystać z Assistant Simulator i wyświetlać logi Cloud Logging:
Zaloguj się przez Google
Możesz zalogować się na swoje konto dewelopera w panelu Google Home, aby autoryzować Android Studio do komunikacji z usługami Google w Twoim imieniu.
W kolumnie kart pionowych po lewej stronie okna Android Studio kliknij kartę Google Home.
W sekcji Zaloguj się kliknij Google, aby uruchomić przeglądarkę.
Wybierz konto połączone z urządzeniami inteligentnego domu.
Na stronie autoryzacji Zaloguj się przez Google kliknij Zezwól.
Zamknij okno przeglądarki i wróć do Android Studio.
Powinieneś być teraz zalogowany z opcją Wyloguj.
Wybierz projekt Cloud
Po zalogowaniu się wybierz Projekt z menu. Aby przefiltrować listę projektów, wpisz wyrażenie Filtr, np. matter, a potem naciśnij Enter.
Menu Projekt wczytuje pierwsze 100 projektów na podstawie filtra. Wybrane opcje są zachowywane po wyjściu z Android Studio.
Więcej informacji o filtrach projektu znajdziesz w dokumentacji Google Cloud w sekcji Parametry zapytań.
Korzystanie z symulatora Asystenta
Aby otworzyć panel Assistant Simulator w panelu Android Studio, kliknij Panel wypowiedzi w panelu Google Home Plugin.
Zapytania do Assistant Simulator można wysyłać na kilka sposobów. Teraz omówimy każdą z nich.
Pisanie zapytań i zbieranie odpowiedzi
Aby korzystać z Assistant Simulator, wpisz zapytanie i naciśnij Enter.
Aby ponownie wysłać zapytanie, kliknij ikonę ponownego wysyłania na końcu zapytania.
Po przesłaniu co najmniej 1 zapytania kliknij Powtórz, aby ponownie uruchomić zapytania i sprawdzać odpowiedzi. Panel Wypowiedzi śledzi Twoje zapytania i odpowiedzi w zapisanym pliku pamięci podręcznej. Powtórz dodaje do tego wewnętrznego pamięci podręcznej tylko nowe odpowiedzi i nie będzie duplikować zapytań za każdym razem, gdy klikniesz przycisk.
Aby zapisać zapytania i odpowiedzi wprowadzone w panelu Utrężenia, kliknij Zapisz. Interakcje są konwertowane do formatu JSON w ten sposób:
ask: Twoje zapytanie.answers: tablica możliwych odpowiedzi Assistant Simulator.
Ten plik JSON możesz edytować w 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 z wypowiedziami, aby otworzyć zapisane pliki JSON w nowej karcie. W przypadku Wybierz ścieżkę możesz wybrać plik lub folder. Jeśli wybierzesz folder, polecenia Zbieraj i Testuj będą działać na wszystkich plikach .json w tym folderze.
Możesz otworzyć kilka kart z tym samym plikiem lub z różnymi plikami, na przykład lights, lights(1) i plug.
Pasek stanu zawiera wynik ostatniego testu (jeśli dotyczy), żółtą lub zieloną kropkę, która wskazuje, czy plik został zebrany, oraz ścieżkę do pliku utterance .json. Po kliknięciu Zbierz usługa Assistant Simulator wykona Twoje zapytania.
Powiadomimy Cię, gdy otrzymamy nową odpowiedź, a pasek stanu będzie wyświetlać licznik podczas przetwarzania zapytań.
Po zakończeniu działania Zbierz pasek stanu zostanie zaktualizowany i przed ścieżką .json pojawi się zielony znacznik, a pliki wypowiedzi zostaną wypełnione możliwymi 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 zbieranie danych przedwcześnie, ścieżka .json nie zostanie oznaczona jako zebrana.
Testowanie zbioru wypowiedzi
Po zebraniu odpowiedzi kliknij Test, aby ponownie wykonać zapytania i sprawdzić odpowiedzi oraz dzienniki. Podczas testowania zbiorczych wypowiedzi usługa Assistant Simulator oczekuje odpowiedzi zapisanych w pliku JSON. Jeśli test zwróci odpowiedź, która nie została zebrana, otrzymasz powiadomienie podobne do tego:
Expected one of: "Got it, turning on
2 lights."
Ten scenariusz wskazuje na nieudany test. W przeciwnym razie funkcja Assistant Simulator wykona wszystkie Twoje zapytania i zwróci odpowiedź. Jeśli test się powiedzie, na pasku stanu pojawi się znak zaznaczenia .
Wyświetlanie Cloud Logging
Aby otworzyć kartę projektu w oknie narzędzia Cloud Logs, w panelu Google Home Plugin kliknij Cloud Logs (Logi Cloud). Możesz otworzyć osobne karty dziennika Cloud dla każdego z Twoich projektów.
Wyszukiwane hasła
W przypadku wybranego projektu możesz też filtrować logi za pomocą pola Zapytanie.
Aby na przykład przefiltrować dzienniki według słowa kluczowego light:
Aby używać języka zapytań usługi Logging, wybierz Użyj QL.
Oto kilka przykładowych zapytań QL, które ułatwią Ci rozpoczęcie pracy:
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
Wyszukiwanie dzienników według daty jest opcjonalne i można je włączyć, klikając Po i Przed. Format daty i godziny możesz wpisać w dostępnym polu tekstowym, np. 5/11/22, 12:37 PM, lub użyć selektora daty , aby wybrać datę, a potem wpisać godzinę w polu tekstowym.
- Aby wybrać datę po
5/1/22, kliknij Po, a następnie ikonę daty . - Aby wybrać datę wcześniejszą niż
5/1/22, kliknij Wcześniej, a następnie kliknij ikonę daty . - Aby wybrać datę między
5/1/22a6/30/22, kliknij Przed i Po, a potem wybierz daty za pomocą ikony daty .
Aby pobrać logi projektu w czasie rzeczywistym, wybierz Czas rzeczywisty. Aby zakończyć przesyłanie danych w czasie rzeczywistym, kliknij Zatrzymaj.
Poziom ważności
Możesz też wybrać Minimalna waga z menu.
Wyniki zapytania
Aby przesłać parametry zapytania, kliknij Pobierz.
Po załadowaniu logów kliknij dowolny rekord (), aby rozwinąć pełny ładunek JSON. Aby wyświetlić pełną wiadomość, kliknij ponownie .
Opcjonalnie możesz wpisać słowo kluczowe w polu Filtr, aby zawęzić wyniki dziennika. Kliknij x, aby usunąć filtr i wrócić do pierwotnych wyników zapytania.
Wyświetlanie wykresu głównego i przeprowadzanie testów
Aby wyświetlić listę urządzeń, w panelu Google Home Plugin kliknij Home Graph.
Kliknij Odśwież, aby wyświetlić Nazwa urządzenia, Identyfikator urządzenia i Typ urządzenia powiązane 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 danych JSON.
Możesz też użyć opcji Rozwiń i Zwiń, aby wyświetlać i ukrywać dane JSON dotyczące urządzeń.
Aby uruchomić Test Suite na konkretnym urządzeniu, kliknij Testuj. Spowoduje to uruchomienie w przeglądarce pakietu testów z wybranym urządzeniem, które jest gotowe do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.
Po zakończeniu testów możesz sprawdzić ich szczegóły i otwarte dzienniki.
Przeglądarka logów Android Debug Bridge (adb)
Aby otworzyć kartę projektu w oknie narzędzia Adb Log, na pasku narzędzi wtyczki Google Home (po lewej stronie) kliknij polecenie Adb Log. Dla każdego pliku dziennika możesz otworzyć oddzielną kartę dziennika Adb. Aby usunąć kartę, kliknij ikonę .
W polu Wybierz wybierz konkretny element logowania, który chcesz wyświetlić, a w menu Powaga wyświetlaj tylko wpisy o odpowiedniej wadze.
W wybranym pliku dziennika adb możesz filtrować wpisy dziennika za pomocą pola Filtr z opcjonalnymi modyfikatorami Wrażliwość na wielkość liter lub Wyrażenie regularne.
Dodatkowo możesz:
- Znajdź konkretne wpisy, korzystając z pola Znajdź oraz poleceń Znajdź następne (ikona ) i Znajdź poprzednie (ikona ).
- Użyj opcjonalnych modyfikatorów Rozróżniaj wielkość liter lub Wyrażenie regularne.
- Przejdź do wiersza, aby przejść do określonego wiersza (według numeru) w logu.
Wybierz Numerowany, aby wyświetlić wiersze dziennika z dodanymi numerami wierszy. Aby wyświetlić nieprzetworzone wpisy w logu, wybierz Nieprzetworzone.
Zasoby i opinie
Kliknij Materiały, aby wyświetlić listę narzędzi i materiałów dla deweloperów.
Aby przesłać swoje przemyślenia lub opinię o tym, jak możemy ulepszyć proces tworzenia aplikacji Google Home Plugin, kliknij Opinie.
