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 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 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świetl 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 wsadowe
Assistant Simulator odpowiedzi na jedną wypowiedź nie są deterministyczny. 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 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 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ć aplikację 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 > 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.
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 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. Następnie Omówimy każdą z tych 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. W panelu Wyrażenia śledzi zapytań i odpowiedzi w przechowywanej 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 PrzyciskKliknij
Zapisz, aby zapisać zapytania. odpowiedzi wpisane w polu Panel Wyrażenia. Interakcje są konwertowane do formatu JSON w następujący sposób: format: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, opcje Zbieraj i testuj
pracować na wszystkich plikach .json
wypowiedzi z wyrażenia 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.
Po zebraniu nowej odpowiedzi otrzymasz powiadomienie, a pasek stanu
wyświetla licznik podczas przetwarzania zapytań.
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 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 tej odpowiedzi:
Przetestuj, aby ponownie odtworzyć zapytania oraz sprawdzić odpowiedzi i dzienniki. Gdy testujesz wypowiedzi wsadowe,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ź. 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/22
a6/30/22
, wybierz Przed i Po i wybierz daty, klikając ikonę 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ć z menu opcję Minimalna waga.
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 Google Home Graph.
Odśwież, aby wyświetlić Nazwa urządzenia, Identyfikator urządzenia i Typ urządzenia związane z Twoimi urządzeniami. powiązane z wybranym projektem. Możesz mieć wiele W przypadku osobnych projektów otwierają się panelePo 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ć i ukryć plik JSON dla Twoich 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 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, 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ę.