Wtyczka Google Home do Androida Studio

Matter ; Home APIs

Google Home Plugin for Android Studio została zaprojektowana i stworzona z myślą o deweloperach korzystających z platformy Google Home. Dzięki tej wtyczce masz dostęp do Google Assistant Simulator, Cloud Logging i innych narzędzi, które upraszczają proces tworzenia inteligentnego domu.

Uwagi dotyczące bezpieczeństwa

Aby uniemożliwić Android Studio przechowywanie tajnych kluczy i haseł, wykonaj te czynności:

1. Kliknij kolejno Plik i Ustawienia....
2. W sekcji Wygląd i zachowanie rozwiń Ustawienia systemu , a następnie kliknij Hasła.
3. Wybierz Nie zapisuj, zapomnij hasła po ponownym uruchomieniu.

Funkcje

Symulator Asystenta

Aby sprawdzić, czy urządzenia inteligentnego domu działają prawidłowo w ekosystemie Google Home , możesz w każdej chwili korzystać z Assistant Simulator bez opuszczania Android Studio.

Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, np. „Włącz światło” W Android Studio, Assistant Simulator odpowiada wiadomościami tekstowymi na podstawie Twoich poleceń, np. „OK, włączam światło”

Wyświetlanie Cloud Logging

Google Cloud Logging zawiera informacje na potrzeby debugowania i kluczowe dane, które pozwalają uzyskać wgląd w sposób korzystania z Twojej akcji. Aby uprościć proces tworzenia, Google Home Plugin wyświetla wiadomości w czasie rzeczywistym Cloud Logging obok kodu podczas rozwiązywania problemów.

Możesz wyświetlać logi w czasie rzeczywistym lub wybrać zakres dat.

Wypowiedzi zbiorcze

Assistant Simulator odpowiedzi na pojedynczą wypowiedź nie są deterministyczne. Odpowiedź może być na przykład jednym z tych wyrażeń:

• OK, włączam 2 światła.
• Jasne, włączam 2 światła.
• OK, włączam 2 światła.
• Dobrze, włączam 2 światła.

Aby przeprowadzać automatyczne testy i sprawdzać, jak integracje Google działają z tymi różnymi odpowiedziami, możesz wysyłać wypowiedzi zbiorcze do Assistant Simulator uruchamiając skrypty wypowiedzi. Po zapisaniu skryptu możesz zbierać odpowiedzi i przeprowadzać wiele testów na podstawie swoich zapytań.

Wyświetlający Home Graph

Wyświetlający Home Graph umożliwia wyświetlanie stanu urządzeń i uruchamianie pakietu testów Google Home w przeglądarce.

Wyświetlający logi Android Debug Bridge (adb)

Wyświetlający logi adb to narzędzie do wyświetlania i analizowania plików dziennika, np. Matter plików dziennika urządzeń, logów Google Home i logów Androida.

Zainstaluj

Aby zainstalować Google Home Plugin w Android Studio, wykonaj następujące kroki:

1. Pobierz lub zaktualizuj Android Studio. Pobierz Android Studio
2. Otwórz Plik > Ustawienia (Android Studio > Preferencje w systemie MacOS).
3. W sekcji Wtyczki otwórz Marketplace i wyszukaj google home.
4. Zainstaluj narzędzie i ponownie uruchom Android Studio.

Wtyczkę możesz też pobrać bezpośrednio z JetBrains Marketplace.

Konfiguracja

Po zainstalowaniu wtyczki musisz wykonać te czynności, zanim zaczniesz korzystać z Assistant Simulator i wyświetlać Cloud Logging:

• Zaloguj się przez Google
• Wybierz projekt w chmurze

Zaloguj się przez Google

Możesz zalogować się na konto dewelopera w panelu sterowania urządzeniami domowymi Google Home, autoryzując Android Studio do komunikowania się z usługami Google w Twoim imieniu.

1. W kolumnie kart pionowych po lewej stronie okna Android Studio kliknij kartę Google Home.

2. W sekcji Zaloguj się przez kliknij Google, aby otworzyć przeglądarkę.

   

3. Wybierz konto powiązane z urządzeniami inteligentnego domu.

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

5. Zamknij okno przeglądarki i wróć do Android Studio.

Powinno się teraz wyświetlać, że jesteś zalogowany(-a), i opcja Wyloguj się.

Wybierz projekt w chmurze

Po zalogowaniu wybierz Projekt z menu. Aby filtrować listę projektów, wpisz wyrażenie Filtr, np. matter, a następnie naciśnij Enter.

Menu Projekt wczytuje pierwsze 100 projektów na podstawie Filtra. Wybrane przez Ciebie opcje są zachowywane po zamknięciu Android Studio.

Aby uzyskać pomoc dotyczącą filtrów projektów, zapoznaj się z parametrami zapytań w dokumentacji Google Cloud.

Korzystanie z symulatora Asystenta

Aby otworzyć Assistant Simulator w Android Studio, kliknij Panel wypowiedzi w panelu Google Home Plugin.

Zapytania do Assistant Simulator można wysyłać na kilka sposobów. Teraz omówimy każdą z tych opcji.

Wpisywanie zapytań i zbieranie odpowiedzi

Aby korzystać z Assistant Simulator, wpisz zapytanie i naciśnij Enter.

Możesz ponownie wysłać zapytanie, klikając ikonę ponownego wysyłania cached na końcu zapytania.

Po przesłaniu co najmniej 1 zapytania kliknij cached Odtwórz, aby ponownie uruchomić zapytania i sprawdzić odpowiedzi. Panel Wypowiedzi śledzi zapytania i odpowiedzi w przechowywanej pamięci podręcznej. Opcja Odtwórz dodaje tylko nowe odpowiedzi do tej wewnętrznej pamięci podręcznej i nie duplikuje zapytań za każdym razem, gdy klikniesz ten przycisk.

Kliknij ikonę zapisywania save Zapisz , aby zapisać zapytania i odpowiedzi wpisane w panelu Wypowiedzi. Twoje interakcje są konwertowane na format JSON:

• ask: Twoje zapytanie.
• answers: tablica możliwych odpowiedzi Assistant Simulator.

Ten plik JSON możesz edytować 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 Zbierz i Przetestuj będą działać na wszystkich plikach wypowiedzi .json w tym folderze.

Możesz otworzyć kilka kart dla tego samego pliku lub różnych plików, np. lights, lights(1), i plug.

Pasek stanu wyświetla wynik ostatniego testu (jeśli dotyczy), żółtą lub zieloną kropkę wskazującą, czy plik został zebrany, oraz ścieżkę do pliku wypowiedzi .json. Gdy klikniesz ikonę zbierania tocZbierz, symulator Asystenta uruchomi Twoje zapytania.Assistant Simulator Gdy zostanie zebrana nowa odpowiedź, otrzymasz powiadomienie, a Pasek stanu będzie wyświetlać licznik podczas przetwarzania zapytań.

Gdy Zbierz zakończy działanie, Pasek stanu zostanie zaktualizowany o zielony symbol zaznaczenia przed ścieżką .json, a pliki wypowiedzi zostaną wypeł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 zbieranie przedwcześnie, ścieżka .json nie zostanie oznaczona jako zebrana.

Testowanie wypowiedzi zbiorczych

Po zebraniu odpowiedzi kliknij switch_left Przetestuj, aby ponownie odtworzyć zapytania i sprawdzić odpowiedzi oraz logi. Podczas testowania wypowiedzi zbiorczych Assistant Simulator oczekuje odpowiedzi zapisanych w pliku JSON. Jeśli test zwróci odpowiedź, która nie została zebrana, otrzymasz powiadomienie podobne do tego:

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

Ten scenariusz oznacza nieudany test. W przeciwnym razie Assistant Simulator uruchomi każde z Twoich zapytań i zwróci odpowiedź. Jeśli test się powiedzie, na **Pasku stanu** pojawi się ikona potwierdzenia check check.

Wyświetlanie Cloud Logging

Aby otworzyć kartę projektu w oknie narzędzia Cloud Logs, kliknij Cloud Logs w panelu Google Home Plugin. Możesz otworzyć osobne karty Cloud Logs dla każdego projektu.

Wyszukiwane hasła

W przypadku wybranego projektu możesz też filtrować logi za pomocą pola Zapytanie. Aby na przykład filtrować logi według słowa kluczowego light:

Aby używać języka zapytań usługi Logging, kliknij Użyj QL.

Oto kilka przykładów zapytań QL, które pomogą Ci 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

Opcjonalne jest też wyszukiwanie logów według daty. Możesz je włączyć, klikając Po i Przed. Format daty i godziny możesz wpisać w podanym polu tekstowym , np. 5/11/22, 12:37 PM, lub użyć selektora dat calendar_month , aby wybrać datę, a następnie wpisać godzinę w polu tekstowym.

• Aby wybrać datę po 5/1/22, kliknij Po i ikonę daty calendar_month.
• Aby wybrać datę przed 5/1/22, kliknij Przed i ikonę daty calendar_month.
• Aby wybrać datę między 5/1/22 a 6/30/22, kliknij Przed i Po , a następnie wybierz daty za pomocą ikony daty calendar_month.

Aby pobrać logi projektu na żywo, kliknij W czasie rzeczywistym. Aby zakończyć przesyłanie w czasie rzeczywistym, kliknij Zatrzymaj.

Poziom ważności

Możesz też wybrać Minimalny poziom ważności z menu.

Wyniki zapytania

Aby przesłać parametry zapytania, kliknij cached Pobierz

Po wczytaniu logów kliknij dowolny rekord chevron_right, aby rozwinąć pełny ładunek JSON. Kliknij ponownie chevron_left , aby wyświetlić pełną wiadomość.

Opcjonalnie możesz wpisać słowo kluczowe w polu Filtr, aby zawęzić wyniki logów. Kliknij x, aby usunąć filtr i wrócić do pierwotnych wyników pobierania.

Wyświetlanie Home Graph i przeprowadzanie testów

Aby wyświetlić listę urządzeń, w panelu Google Home Plugin kliknij Home Graph.

Kliknij cached Odśwież, aby wyświetlić Nazwę urządzenia, Identyfikator urządzenia i Typ urządzenia dla urządzeń powiązanych z wybranym projektem. Możesz mieć otwartych kilka Google Home Graph paneli dla różnych projektów.

Po wczytaniu urządzeń kliknij dowolny rekord chevron_right, aby rozwinąć pełny ładunek JSON.

Możesz też użyć opcji Rozwiń i Zwiń , aby wyświetlać i ukrywać ładunki JSON urządzeń.

Aby uruchomić pakiet testów dla konkretnego urządzenia, kliknij Przetestuj. Spowoduje to uruchomienie pakietu testów w przeglądarce z wybranym urządzeniem gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.

Po zakończeniu testów możesz sprawdzić ich szczegóły i wyświetlić logi.

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 stronie) kliknij polecenie Adb Log. Możesz otworzyć osobne karty Adb Log dla każdego pliku dziennika. Aby usunąć kartę, kliknij ikonę clear.

Użyj pola Wybierz , aby wybrać konkretny komponent logowania do wyświetlenia, oraz menu Poziom ważności , aby wyświetlać tylko wpisy o pasującym poziomie ważności logu.

W przypadku wybranego logu adb możesz filtrować wpisy logu za pomocą pola Filtr z opcjonalnymi modyfikatorami Uwzględniaj wielkość liter lub Wyrażenie regularne.

Dodatkowo możesz:

• Znajdować konkretne wpisy za pomocą pola Znajdź oraz poleceń Znajdź następny (arrow_downward ikona) i Znajdź poprzedni (arrow_upward ikona).
• Używać opcjonalnych modyfikatorów Uwzględniaj wielkość liter lub Wyrażenie regularne.
• Przejdź do wiersza , aby przejść do określonego wiersza (według numeru) w logu.

Aby wyświetlić wiersze logu z dodanymi numerami wierszy, kliknij Numerowane. Aby wyświetlić nieprzetworzone wpisy logu, kliknij Nieprzetworzone.

Zasoby i opinie

Aby wyświetlić listę narzędzi i zasobów dla deweloperów, kliknij Zasoby.

Aby przesłać swoje przemyślenia lub opinie na temat tego, jak możemy ulepszyć proces tworzenia za pomocą Google Home Plugin, kliknij Prześlij opinię.