Wtyczka Google Home do Androida Studio

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.

Wtyczka Google Home do Android Studio

Informacje na temat bezpieczeństwa

Aby uniemożliwić usłudze Android Studio przechowywanie obiektów tajnych i haseł, wykonaj te czynności:

  1. Kliknij File (Plik), a następnie Settings... (Ustawienia...).
  2. W sekcji Wygląd Działanie, rozwiń Ustawienia systemu i kliknij Hasła.
  3. Wybierz Nie zapisuj, po ponownym uruchomieniu zapomnij hasła.
Wtyczka Google Home do Android Studio

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”.

Testowanie za pomocą symulatora Asystenta

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.

Widok Cloud Logging

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:

  1. Pobierz lub zaktualizuj aplikację Android Studio. Pobierz Android Studio
  2. Kliknij Plik > Ustawienia (Android Studio > Ustawienia w systemie macOS).
  3. W sekcji Wtyczki otwórz Marketplace i wyszukaj google home
  4. 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.

  1. Kliknij kartę Google Home w pionowej kolumnie kart po lewej stronie. po drugiej stronie okna Android Studio.

  2. W polu Zaloguj się przez kliknij Google, aby uruchomić przeglądarkę.

    Logowanie do Google w Android Studio
  3. Wybierz konto połączone z inteligentnymi urządzeniami domowymi.

  4. Na stronie autoryzacji Zaloguj się przez Google kliknij Zezwól.

  5. 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

Wybierz projekt

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.

Otwórz 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 Przycisk

Ponowne odtwarzanie wypowiedzi w symulatorze Asystenta

Kliknij 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ń.

Zbieranie wypowiedzi za pomocą symulatora Asystenta

Gdy funkcja Collect dobiegnie końca, na pasku stanu pojawi się zielone potwierdzenie. przed ścieżką .json, a pliki wypowiedzi zawierają możliwych odpowiedzi.

Zbieranie wypowiedzi za pomocą symulatora Asystenta
{
  "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 Przetestuj, aby ponownie odtworzyć zapytania oraz sprawdzić odpowiedzi i 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 tej odpowiedzi:

Expected one of: "Got it, turning on 2 lights."

Uruchamianie wypowiedzi w symulatorze Asystenta

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ł.

Uruchamianie wypowiedzi w symulatorze Asystenta

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.

Karty Cloud Logging

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:

Zapytanie Cloud Logging

Wybierz Użyj QL, aby użyć funkcji Język zapytań.

Język zapytań w usłudze Cloud Logging

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 a 6/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 Cloud Logging

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 związane z Twoimi urządzeniami. 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.

Ładunek JSON wykresu głównego

Możesz też użyć opcji Rozwiń i Zwiń, aby wyświetlić i ukryć plik JSON dla Twoich urządzeń.

Rozwiń i zwiń wykres Home Graph w formacie JSON

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.

Testy uruchomień Home Graph

Po jego zakończeniu możesz sprawdzić szczegóły testu i wyświetlić dzienniki.

Home Graph Ukończone testy

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.

Wyświetlający logi Adb

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ę.

Prześlij opinię