Google Home Plugin for Android Studio został zaprojektowany i stworzony dla deweloperów Google Home Platform. Ta wtyczka zapewnia dostęp do Google Assistant Simulator, Cloud Logging i innych narzędzi, które upraszczają proces programowania inteligentnego domu.
Uwagi dotyczące bezpieczeństwa
Aby uniemożliwić Android Studio przechowywanie obiektów tajnych i haseł, wykonaj te czynności:
- Kliknij Plik, a następnie Ustawienia...
- W sekcji Wygląd i zachowanie rozwiń Ustawienia systemu i kliknij Hasła.
- Wybierz Nie zapisuj, zapominaj hasła po ponownym uruchomieniu.
Funkcje
Symulator Asystenta
Aby sprawdzić, czy inteligentne urządzenia domowe działają prawidłowo z ekosystemem Google Home, możesz w każdej chwili wejść w interakcję z usługą Assistant Simulator bez opuszczania usługi Android Studio.
Podobnie jak w przypadku dotychczasowego symulatora Asystenta w konsoli Actions on Google Console, Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, na przykład „Włącz światło”. W aplikacji Android Studio Assistant Simulator odpowiada SMS-em na podstawie Twoich poleceń, na przykład: „OK, włączam światło”.
Wyświetl Cloud Logging
Raport Google Cloud Logging zawiera informacje na potrzeby debugowania i kluczowe dane, które dają wgląd w użycie akcji. Aby uprościć programowanie, Google Home Plugin wyświetla komunikaty Cloud Logging w czasie rzeczywistym obok kodu podczas rozwiązywania problemów.
Możesz wyświetlić dzienniki czasu rzeczywistego lub wybrać zakres dat.
Wypowiedzi wsadowe
Odpowiedzi typu Assistant Simulator na pojedynczą wypowiedź nie są deterministyczne. Odpowiedź może być na przykład jednym z tych wyrażeń:
- Rozumiem, włączam dwa światła.
- Jasne, włączam dwa światła.
- Rozumiem, włączam dwa światła.
- Dobrze, włączam dwa światła.
Aby uruchomić testy automatyczne i sprawdzić, jak Twoje integracje Google działają z tymi różnymi odpowiedziami, możesz wysyłać wsadowe wypowiedzi do usługi Assistant Simulator, uruchamiając skrypty wypowiedzi. Po zapisaniu skryptu możesz zebrać odpowiedzi i przetestować swoje zapytania.
Wyświetlający Home Graph
Przeglądarka Home Graph umożliwia wyświetlanie stanu urządzeń i uruchamianie w przeglądarce pakietu Google Home Test Suite.
Wyświetlający logi Android Debug Bridge (adb)
Przeglądarka logów Adb to narzędzie do wyświetlania i analizowania plików dziennika, na przykład plików dziennika urządzenia Matter, dzienników Google Home i dzienników Androida.
Zainstaluj
Aby zainstalować Google Home Plugin w Android Studio, wykonaj te czynności:
- Pobierz lub zaktualizuj Android Studio. Pobierz Android Studio
- W systemie macOS wybierz Plik > Ustawienia (Android Studio > Preferencje).
- W sekcji Wtyczki kliknij Marketplace i wyszukaj
google home. - Zainstaluj to narzędzie i uruchom ponownie aplikację 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ć narzędzia Assistant Simulator i wyświetlać Cloud Logging:
Zaloguj się przez Google
Możesz zalogować się na swoje konto dewelopera w panelu Google Home, aby zezwolić usłudze Android Studio na komunikowanie się z usługami Google w Twoim imieniu.
Kliknij kartę Google Home w kolumnie kart pionowych po lewej stronie okna Android Studio.
W polu Zaloguj się przez kliknij Google, aby uruchomić przeglądarkę.
Wybierz konto połączone z inteligentnymi urządzeniami domowymi.
Na stronie autoryzacji Zaloguj się przez Google kliknij Zezwól.
Zamknij okno przeglądarki i wróć do Android Studio.
Po zalogowaniu zobaczysz opcję Wyloguj się.
Wybierz projekt Cloud
Gdy się zalogujesz, wybierz z menu Projekt. Aby filtrować listę projektów, wpisz wyrażenie Filtr, na przykład matter, i naciśnij Enter.
Menu Projekt wczytuje pierwsze 100 projektów na podstawie Twojego filtra. Wybrane opcje zostaną zachowane po zamknięciu okna Android Studio.
Pomoc dotyczącą filtrów 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 usługi Assistant Simulator na kilka sposobów. Teraz przyjrzymy się każdej opcji.
Wpisywanie zapytań i zbieranie odpowiedzi
Aby wejść w interakcję z polem Assistant Simulator, wpisz zapytanie i naciśnij Enter.
Możesz wysłać zapytanie jeszcze raz, klikając ikonę ponownego wysyłania na końcu zapytania.
Po przesłaniu co najmniej jednego zapytania kliknij Odtwórz ponownie, aby jeszcze raz je wykonać i sprawdzić odpowiedzi. Panel Wyrażenia śledzi Twoje zapytania i odpowiedzi w pamięci podręcznej. Odtwórz ponownie tylko dodaje nowe odpowiedzi do tej wewnętrznej pamięci podręcznej – nie duplikuje zapytań za każdym razem, gdy klikniesz przycisk.
Kliknij Zapisz, aby zapisać zapytania i odpowiedzi wpisane w panelu Wyrażenia. Interakcje są konwertowane do formatu JSON:
ask: Twoje zapytanie.answers: tablica możliwych odpowiedzi (Assistant Simulator).
Możesz edytować ten plik JSON 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 wyrażeń, aby otworzyć zapisane pliki JSON w nowej karcie. W polu Wybierz ścieżkę możesz wybrać plik lub folder. Jeśli wybierzesz folder, opcje Zbieraj i Testuj będą działać na wszystkich plikach .json z wyrażeniami w tym folderze.
Możesz otworzyć wiele kart tego samego pliku lub różnych plików, na przykład lights, lights(1) i plug.
Na pasku stanu wyświetlany jest wynik ostatniego testu (w stosownych przypadkach), żółta lub zielona kropka wskazująca, czy plik został zebrany, oraz ścieżka do pliku .json z wyrażeniem. Gdy klikniesz Zbieraj, Assistant Simulator uruchomi Twoje zapytania.
Otrzymasz powiadomienie o zebraniu nowej odpowiedzi, a w trakcie przetwarzania Twoich zapytań na pasku stanu widoczny będzie licznik.
Po zakończeniu wykonywania operacji Collect na pasku stanu pojawi się zielona ikona potwierdzenia przed ścieżką .json, a pliki wypowiedzi są wypełniane 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 wcześniej, ścieżka .json nie zostanie oznaczona jako zebrana.
Testowanie wypowiedzi wsadowych
Po zebraniu odpowiedzi kliknij Przetestuj, aby ponownie odtworzyć zapytania i sprawdzić odpowiedzi oraz logi. Gdy testujesz wyrażenia wsadowe, Assistant Simulator oczekuje odpowiedzi, które zostaną zapisane 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."
Ten scenariusz oznacza niepowodzenie testu. W przeciwnym razie Assistant Simulator uruchomi każde zapytanie i zwróci odpowiedź. Jeśli test zakończył się powodzeniem, na pasku stanu pojawi się ikona .
Wyświetl Cloud Logging
Aby otworzyć kartę projektu w oknie narzędzia Cloud Logs, w panelu Google Home Plugin kliknij Logi Cloud. Możesz otworzyć osobne karty logów Cloud dla każdego projektu.
Wyszukiwane hasła
W przypadku wybranego projektu możesz też filtrować logi przy użyciu pola Zapytanie.
Aby na przykład przefiltrować dzienniki pod kątem słowa kluczowego light:
Wybierz Użyj QL, aby użyć języka zapytań dotyczących rejestrowania.
Oto kilka przykładów zapytań o QL, które mogą Ci pomóc 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 też opcjonalne i możesz je włączyć, klikając Po i Przed. Możesz wpisać format daty i godziny w wyświetlonym polu tekstowym, np. 5/11/22, 12:37 PM, lub użyć selektora dat , aby wybrać datę, a następnie wpisać godzinę w polu tekstowym.
- Aby wybrać datę po
5/1/22, wybierz Po i kliknij ikonę daty . - Aby wybrać datę wcześniejszą niż
5/1/22, wybierz Przed i kliknij ikonę daty . - Aby wybrać datę między
5/1/22a6/30/22, kliknij Przed i Po, a potem wybierz daty, klikając ikonę daty .
Wybierz Czas rzeczywisty, aby pobrać logi projektu na żywo. Kliknij Zatrzymaj, aby zakończyć przesyłanie pliku danych w czasie rzeczywistym.
Poziom ważności
Możesz też wybrać z menu Minimalna waga.
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ć pełną wiadomość.
Opcjonalnie możesz wpisać słowo kluczowe w polu Filtr, aby zawęzić wyniki w logu. Kliknij x, aby usunąć filtr i wrócić do oryginalnych wyników pobierania.
Wyświetl wykres na stronie głównej i przeprowadź testy
Aby wyświetlić listę urządzeń, w panelu Google Home Plugin wybierz Home Graph.
Kliknij Odśwież, aby wyświetlić Nazwa urządzenia, Identyfikator urządzenia i Typ urządzenia powiązanych z wybranym projektem. Możesz mieć otwartych wiele paneli Google Home Graph na potrzeby osobnych projektów.
Po wczytaniu urządzeń kliknij dowolny rekord , aby rozwinąć pełny ładunek JSON.
Możesz też użyć opcji Rozwiń i Zwiń, aby wyświetlić lub ukryć ładunki JSON dotyczące urządzeń.
Aby uruchomić pakiet Test Suite na konkretnym urządzeniu, kliknij Testuj. Spowoduje to uruchomienie w przeglądarce pakietu Test Suite z wybranym urządzeniem i gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.
Możesz sprawdzić szczegóły testu i wyświetlić logi po jego zakończeniu.
Wyświetlający logi Android Debug Bridge (adb)
Aby otworzyć kartę projektu w oknie narzędzia Adb Log, kliknij polecenie Adb Log na pasku narzędzi wtyczki Google Home (po lewej stronie). Dla każdego pliku dziennika możesz otworzyć osobne karty dziennika Adb. Aby usunąć kartę, kliknij ikonę .
Za pomocą pola Wybierz wybierz konkretny komponent logowania, który chcesz wyświetlić, i użyj menu Waga, aby wyświetlić tylko wpisy z pasującą wagą logu.
W przypadku wybranego logu adb możesz filtrować wpisy w logu, korzystając z pola Filtr z opcjonalnymi modyfikatorami Z uwzględnieniem wielkości liter i Wyrażenia regularne.
Dodatkowo możesz:
- Określone wpisy możesz znaleźć za pomocą pola Znajdź oraz poleceń Znajdź następny (ikona ) i Znajdź poprzedni (ikona ).
- Użyj opcjonalnych modyfikatorów Z uwzględnieniem wielkości liter lub Regex.
- 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 Nieprzetworzone, aby wyświetlić nieprzetworzone wpisy logu.
Zasoby i opinie
Kliknij Zasoby, aby wyświetlić listę zasobów i narzędzi dla programistów.
Aby przesłać nam uwagi lub opinie na temat tego, jak możemy ulepszyć narzędzie Google Home Plugin, kliknij Prześlij opinię.
