Urządzenie Google Home Plugin for Android Studio zostało opracowane z myślą o Google deweloperów Home Platform. Ta wtyczka zapewnia dostęp do Google Assistant Simulator, Cloud Logging i inne narzędzia, aby uprościć procesu projektowania 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 zachowanie rozwiń Ustawienia systemowe, a potem 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 Google Home możesz korzystać z usługi Assistant Simulator w dowolnej chwili i bez opuszczając miejsce Android Studio.
Podobna do Asystenta Symulator jest dostępny w konsoli Actions on Google Console Assistant Simulator umożliwia aby łatwo sterować urządzeniami, wpisując zapytania, na przykład „Włącz światło”. W aplikacji Android Studio Assistant Simulator odpowiada, wysyłając SMS-y na podstawie Twojej poleceń, na przykład „OK, włączam światło”.
Wyświetlanie Cloud Logging
Google Cloud Logging znajdziesz informacje na temat debugowania i kluczowe wskaźniki, które pozwolą Ci Wykorzystanie akcji. Aby uprościć programowanie, Google Home Plugin pokazuje: Cloud Logging w czasie rzeczywistym obok Twojego kodu, podczas w rozwiązywaniu problemów.
Możesz wyświetlić dzienniki w czasie rzeczywistym lub wybrać zakres dat.
Wyrażenia zbiorcze
Assistant Simulator odpowiedzi na jedną wypowiedź nie są deterministyczny. Odpowiedzi mogą zawierać dowolne z tych wyrażeń:
- Rozumiem, włączam 2 światła.
- Jasne, włączam dwa światła.
- OK, włączam dwa światła.
- Dobrze, włączam dwa światła.
Aby przeprowadzać automatyczne testy i sprawdzać działanie integracji z Google te różne odpowiedzi możesz wysyłać zbiorcze wypowiedzi do Assistant Simulator przez uruchomienie skryptów wypowiedzi. Po wykonaniu skryptu zapisanych, możesz zbierać odpowiedzi i przeprowadzać wiele testów swoich zapytań.
Wyświetlający panel Home Graph
Przeglądarka Home Graph umożliwia: wyświetl stan urządzeń i uruchom Google Home Test Suite w przeglądarce.
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 Pliki dziennika urządzenia Matter, dzienniki Google Home i Android dzienników.
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 > Ustawienia w systemie macOS).
- W sekcji Wtyczki otwórz Marketplace i wyszukaj
google home - Zainstaluj narzędzie i uruchom ponownie aplikację Android Studio.
Wtyczkę możesz też pobrać bezpośrednio z JetBrains Marketplace
Konfiguracja
Po zainstalowaniu wtyczki musisz wykonaj te czynności, by móc używać usług Assistant Simulator i wyświetl Cloud Logging:
Zaloguj się przez Google
Możesz zalogować się na swoje konto dewelopera w panelu Google Home. Upoważnienie domeny Android Studio do komunikowania się z Google usług Google.
Kliknij kartę Google Home w pionowej kolumnie kart po lewej stronie. po drugiej 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.
Powinieneś/powinnaś być teraz zalogowany(-a) i mieć możliwość wylogowania się.
Wybierz projekt Cloud
Po zalogowaniu się wybierz w menu Projekt. Aby przefiltrować listę projektów, wpisz wyrażenie Filtr, np. matter, a następnie naciśnij Enter.
Menu Projekt wczytuje pierwsze 100 projektów na podstawie Filtruj. Wybrane ustawienia zostaną zachowane po zamknięciu Android Studio
Pomoc dotyczącą filtrów projektów znajdziesz tutaj: Parametry zapytania w materiałach referencyjnych Google Cloud.
Użyj symulatora Asystenta
Aby otworzyć plik Assistant Simulator w aplikacji Android Studio: W panelu Google Home Plugin kliknij Panel wypowiedzi.
Zapytania można wysyłać do usługi Assistant Simulator na kilka sposobów. Teraz omówimy każdą z opcji.
Pisanie zapytań i zbieranie odpowiedzi
Aby użyć opcji Assistant Simulator, wpisz zapytanie i naciśnij Wejdź.
Aby ponownie wysłać zapytanie, kliknij Ikona ponownego wysyłania () na końcu do zapytania.
Po przesłaniu co najmniej jednego zapytania kliknij Odtwórz ponownie, aby ponownie uruchomić i sprawdzać odpowiedzi. Panel Wypowiedzi śledzi Twoje zapytania i odpowiedzi w zapisanym pliku pamięci podręcznej. Odtwórz ponownie dodaje nowe odpowiedzi tylko do: tę wewnętrzną pamięć podręczną i nie będzie duplikować zapytań po każdym kliknięciu 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.
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 go otworzyć.
zapisane pliki JSON na nowej karcie. W sekcji Wybierz ścieżkę możesz określić
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ć wiele kart tego samego lub różnych plików.
lights, lights(1) i plug.
Pasek stanu wyświetla wynik ostatniego testu (w odpowiednich przypadkach)
żółtą lub zieloną kropką wskazującą, czy plik został zebrany;
ścieżka do pliku wypowiedzi .json. Po kliknięciu
Zbieraj,
Assistant Simulator uruchamia zapytania.
Otrzymasz powiadomienie, gdy otrzymamy nową odpowiedź. Podczas przetwarzania zapytań w pasku stanu będzie widoczny licznik.
Gdy funkcja Collect dobiegnie końca, na pasku stanu pojawi się zielone potwierdzenie.
przed ścieżką .json, a pliki wypowiedzi zawierają
możliwych odpowiedzi.
{
"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
zgromadzone dane.
Testuj wypowiedzi wsadowe
Po zebraniu odpowiedzi kliknij Test, aby ponownie wykonać zapytania i sprawdzić odpowiedzi oraz dzienniki. Gdy testujesz wypowiedzi wsadowe, Assistant Simulator oczekuje odpowiedzi zapisanych w Twoim 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 oznacza niepowodzenie testu. W przeciwnym razie funkcja Assistant Simulator wykona wszystkie Twoje zapytania i zwróci odpowiedź. Czek jest wyświetlany Pasek stanu, jeśli test się powiódł.
Wyświetl Cloud Logging
Aby otworzyć kartę projektu w oknie narzędzia Logi Cloud, kliknij Cloud Logging (Logi Cloud). w panelu Google Home Plugin. Możesz otworzyć oddzielne karty Cloud Log dla każdego ze swoich projektów.
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ć funkcji Język zapytań.
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 tekście
podanego pola, np. 5/11/22, 12:37 PM, ale możesz też skorzystać z selektorów daty
aby wybrać datę, a następnie wpisz 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 datę ikona . - Aby wybrać datę między
5/1/22a6/30/22, kliknij Przed i Po, a następnie wybierz daty za pomocą ikony daty .
Wybierz Czas rzeczywisty, aby pobrać bieżące logi projektu. Kliknij Stop, by zakończyć z kanału w czasie rzeczywistym.
Poziom ważności
Możesz też wybrać Minimalna waga z menu.
Wyniki zapytania
Kliknij Pobierz, aby przesłać parametrów zapytania.
Po załadowaniu logów kliknij dowolny rekord. , aby rozszerzyć pełną wersję Ładunek JSON. Kliknij jeszcze raz aby wyświetlić pełną wiadomość.
Opcjonalnie możesz wpisać słowo kluczowe w polu Filtr, aby zawęzić dziennik.
wyników. Kliknij x, aby usunąć filtr i wrócić do oryginału
pobierz wyniki.
Wyświetl wykres główny i przeprowadź testy
Aby wyświetlić listę urządzeń, wybierz Home Graph na Panel Google Home Plugin.
Kliknij Odśwież, aby wyświetlić Nazwa urządzenia, Identyfikator urządzenia i Typ urządzenia dla Twoich urządzeń powiązane z wybranym projektem. Możesz mieć wiele W przypadku osobnych projektów otwierają się panele Google Home Graph.
Po załadowaniu urządzeń kliknij dowolny rekord , aby rozszerzyć pełną wersję Ładunek JSON.
Możesz też użyć opcji Rozwiń i Zwiń, aby wyświetlić lub ukryć dane JSON dotyczące urządzeń.
Aby uruchomić Pakiet testów na konkretnym urządzeniu: kliknij Przetestuj. Spowoduje to uruchomienie pakietu Test Suite w przeglądarce z urządzenie zostało wybrane i gotowe do testowania. Kliknij Rozpocznij i poczekaj na rozpoczęcie testu. wyników.
Po zakończeniu testów możesz sprawdzić ich szczegóły i otwarte logi.
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). Możesz otworzyć osobny dziennik Adb poszczególnych plików dziennika. Aby usunąć kartę, kliknij Ikona aplikacji .
W polu Wybierz możesz wybrać konkretny komponent rejestrowania, który chcesz wyświetlić, Waga, aby wyświetlić tylko wpisy o takiej samej ważności.
W przypadku wybranego dziennika adb możesz przefiltrować wpisy za pomocą Filtra z opcjonalnymi modyfikatorami Z uwzględnieniem wielkości liter i Regex.
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 Nieprzetworzony. aby wyświetlić nieprzetworzone wpisy logu.
Zasoby i opinie
Aby wyświetlić listę narzędzi i zasobów dla programistów, kliknij Zasoby.
Podziel się swoimi przemyśleniami i opiniami na temat tego, jak możemy ulepszyć Google Home Plugin, kliknij Prześlij opinię.
