Google Home Plugin for Android Studio zaprojektowano i stworzono z myślą o programistach korzystających z Google Home Platform. Zapewnia ona dostęp do Google Assistant Simulator, Cloud Logging i innych narzędzi, które upraszczają proces programowania inteligentnego domu.
Informacje na temat bezpieczeństwa
Aby uniemożliwić usłudze Android Studio przechowywanie obiektów tajnych i haseł, wykonaj te czynności:
- Kliknij File (Plik), a następnie Settings... (Ustawienia...).
- W sekcji Wygląd i działanie rozwiń Ustawienia systemu i kliknij Hasła.
- Wybierz Nie zapisuj, po ponownym uruchomieniu zapomnij hasła.
Funkcje
Symulator Asystenta
Aby sprawdzić, czy Twoje inteligentne urządzenia domowe działają prawidłowo z ekosystemem Google Home, możesz w dowolnym momencie wejść w interakcję z urządzeniem Assistant Simulator bez opuszczania urządzenia Android Studio.
Podobnie jak Symulator Asystenta dostępny w konsoli Actions on Google Console, Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisanie zapytania, np. „Włącz światło”. W aplikacji Android Studio Assistant Simulator odpowiada, wysyłając SMS-y na podstawie Twoich poleceń, np. „OK, włączam światło”.
Wyświetl Cloud Logging
Strona Google Cloud Logging zawiera informacje na potrzeby debugowania i kluczowe dane, które dostarczają informacji o wykorzystaniu akcji. Aby ułatwić programowanie, Google Home Plugin wyświetla komunikaty Cloud Logging w czasie rzeczywistym obok kodu podczas rozwiązywania problemów.
Możesz wyświetlić dzienniki w czasie rzeczywistym lub wybrać zakres dat.
Wyrażenia wsadowe
Odpowiedzi Assistant Simulator na pojedynczą wypowiedź nie są deterministyczne. Odpowiedź może na przykład być dowolnym z tych wyrażeń:
- OK, włączam dwa światła.
- Jasne, włączam dwa światła.
- OK, włączam dwa światła.
- Dobrze, włączam dwa światła.
Aby przeprowadzić automatyczne testy i sprawdzić, jak integracja z Google działa z tymi różnymi odpowiedziami, możesz wysyłać zbiorcze wypowiedzi głosowe do Assistant Simulator, uruchamiając skrypty wypowiedzi. Po zapisaniu skryptu możesz zbierać odpowiedzi i przeprowadzać wiele testów swoich zapytań.
Wyświetlający Home Graph
Przeglądarka Home Graph umożliwia wyświetlenie stanu urządzeń i uruchomienie w przeglądarce 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, np. plików dziennika urządzenia Matter, dzienników Google Home i dzienników Androida.
Zainstaluj
Aby zainstalować Google Home Plugin w aplikacji Android Studio, wykonaj te czynności:
- Pobierz lub zaktualizuj aplikację Android Studio. Pobierz Android Studio.
- Kliknij Plik > Ustawienia (Android Studio > Preferencje w systemie macOS).
- W sekcji Wtyczki otwórz Marketplace i wyszukaj
google home. - Zainstaluj 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ć usługi Assistant Simulator i wyświetlać Cloud Logging:
Zaloguj się przez Google
Możesz zalogować się na swoje konto dewelopera w panelu Google Home. Upoważniasz aplikacji Android Studio do komunikowania się z usługami Google w Twoim imieniu.
Kliknij kartę Google Home w pionowej kolumnie 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óć na stronę Android Studio.
Powinno się zalogować i masz opcję Wyloguj się.
Wybierz projekt Cloud
Po zalogowaniu się wybierz w menu Projekt. Aby filtrować listę projektów, wpisz wyrażenie Filter (Filtr), na przykład matter, i naciśnij Enter.
Menu Projekt wczytuje pierwsze 100 projektów na podstawie wybranego filtra. Wybrane ustawienia zostaną zachowane po zamknięciu Android Studio.
Pomoc dotyczącą filtrów projektów znajdziesz w artykule Parametry zapytania w Google Cloud Reference.
Użyj symulatora Asystenta
Aby otworzyć Assistant Simulator w Android Studio, w panelu Google Home Plugin kliknij Panel wypowiedzi.
Zapytania można wysyłać do usługi Assistant Simulator na kilka sposobów. Omówimy teraz każdą z opcji.
Pisanie zapytań i zbieranie odpowiedzi
Aby wejść w interakcję z przyciskiem Assistant Simulator, wpisz zapytanie i naciśnij Enter.
Aby wysłać zapytanie jeszcze raz, kliknij 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 przechowuje zapytania i odpowiedzi w przechowywanej pamięci podręcznej. Opcja Odtwórz ponownie dodaje nowe odpowiedzi tylko do tej wewnętrznej pamięci podręcznej i nie powoduje powielania zapytań po każdym kliknięciu przycisku.
Kliknij Zapisz, aby zapisać zapytania i odpowiedzi wpisane w panelu Wyrażenia. Interakcje są konwertowane do formatu JSON w tym formacie:
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 wypowiedzi, aby otworzyć zapisane pliki JSON w nowej karcie. W sekcji Wybierz ścieżkę
możesz wybrać plik lub folder. Jeśli wybierzesz folder, opcje Collect (Zbieraj) i Testuj (Testuj) będą działać na wszystkich plikach .json z wypowiedziami, które się w nim znajdują.
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świetli się wynik ostatniego testu (w stosownych przypadkach), żółta lub zielona kropka wskazująca, czy plik został zebrany, oraz ścieżka pliku .json wypowiedzianej. Po kliknięciu Zbieraj Assistant Simulator uruchomi zapytania.
Powiadomimy Cię o zebraniu nowej odpowiedzi, a na pasku stanu wyświetli się licznik czasu przetwarzania zapytań.
Gdy polecenie Collect ukończy, na pasku stanu przed ścieżką .json pojawi się zielona ikona potwierdzenia, a pliki wypowiedzi zostaną zapeł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 kolekcję wcześniej, ścieżka .json nie zostanie oznaczona jako zebrana.
Testuj wypowiedzi wsadowe
Po zebraniu odpowiedzi kliknij Przetestuj, aby ponownie odtworzyć zapytania oraz sprawdzić odpowiedzi i logi. Gdy testujesz wypowiedzi wsadowe, Assistant Simulator oczekuje odpowiedzi, które zostaną zapisane w pliku JSON. Jeśli test zwróci odpowiedź, która nie została jeszcze 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 wszystkie zapytania i zwróci odpowiedź. Jeśli test się powiedzie, na pasku stanu pojawi się kontrola .
Wyświetl Cloud Logging
Aby otworzyć kartę projektu w oknie narzędzia Logi Cloud, w panelu Google Home Plugin kliknij Logi. Możesz otworzyć oddzielne karty Cloud Log 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 według słowa kluczowego light:
Wybierz Użyj QL, aby użyć języka zapytań logowania.
Oto kilka przykładów zapytań dotyczących jakości usług, które pomogą Ci rozpocząć:
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
Wysyłanie zapytań dotyczących logów według daty jest też opcjonalne. Aby je włączyć, kliknij Po i Przed. Możesz wpisać format daty i godziny w dostępnym polu tekstowym, na przykład 5/11/22, 12:37 PM, lub skorzystać z selektora daty , 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ć bieżące logi projektu. Kliknij Zatrzymaj, aby zamknąć kanał w czasie rzeczywistym.
Poziom ważności
Możesz też wybrać z menu opcję Minimalna waga.
Wyniki zapytania
Aby przesłać parametry zapytania, kliknij Pobierz.
Po załadowaniu 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 główny i przeprowadź testy
Aby wyświetlić listę urządzeń, wybierz Home Graph w panelu Google Home Plugin.
Kliknij Odśwież, aby wyświetlić nazwę urządzenia, identyfikator urządzenia i typ urządzenia powiązanych z wybranym projektem. Możesz mieć otwartych kilka paneli Google Home Graph dla osobnych projektów.
Po załadowaniu urządzeń kliknij dowolny rekord , aby rozwinąć pełny ładunek JSON.
Możesz też użyć opcji Rozwiń i Zwiń, aby wyświetlić i ukryć ładunki JSON dla swoich urządzeń.
Aby uruchomić pakiet testów na konkretnym urządzeniu, kliknij Przetestuj. Spowoduje to uruchomienie pakietu Test Suite w przeglądarce z wybranym urządzeniem i gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.
Po jego zakończeniu możesz sprawdzić szczegóły testu i wyświetlić dzienniki.
Wyświetlający logi Android Debug Bridge (adb)
Aby otworzyć kartę projektu w oknie narzędzia Adb Log, na pasku narzędzi wtyczki Google Home (po lewej) kliknij polecenie Adb Log (Dziennik Adb). Możesz otworzyć oddzielne karty Adb Log dla każdego pliku logu. Aby usunąć kartę, kliknij ikonę .
Pole Wybierz pozwala wybrać konkretny komponent logowania, który chcesz wyświetlić, a w menu Waga możesz wyświetlić tylko wpisy o pasującej ważności logu.
W przypadku wybranego logu adb możesz przefiltrować wpisy logu za pomocą pola Filtr z opcjonalnymi modyfikatorami Z uwzględnieniem wielkości liter lub Wyrażenia regularne.
Dodatkowo możesz:
- Znajdź konkretne wpisy za pomocą pola Znajdź oraz poleceń Znajdź następny (ikona ) i Znajdź poprzednie (ikona ).
- Możesz użyć opcjonalnych modyfikatorów z uwzględnieniem wielkości liter lub wyrażenia regularnego.
- Przejdź do wiersza, aby przejść do określonego wiersza (po numerze) w dzienniku.
Wybierz Numerowane, aby wyświetlić wiersze dziennika z dodanymi numerami. Wybierz Nieprzetworzone, aby wyświetlić nieprzetworzone wpisy logu.
Zasoby i opinie
Aby wyświetlić listę narzędzi i zasobów dla programistów, kliknij Zasoby.
Aby przesłać swoje przemyślenia lub opinię na temat tego, jak możemy ulepszyć programowanie przy użyciu Google Home Plugin, kliknij Prześlij opinię.
