Google Home Extension for Visual Studio Code została zaprojektowana i stworzona z myślą o programistach Google Home Platform. To rozszerzenie zapewnia dostęp do Google Assistant Simulator, Google Cloud Logging, przeglądarki grafu Home oraz innych narzędzi, które upraszczają Matter i proces tworzenia inteligentnego domu.
Funkcje rozszerzenia Google Home
Symulator Asystenta Google
Aby sprawdzić, czy urządzenia inteligentnego domu współpracują prawidłowo z ekosystemem Google Home, możesz w dowolnym momencie wchodzić w interakcję z Assistant Simulator bez wychodzenia z VS Code.
Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, na przykład „Włącz światło”. W VS Code Assistant Simulator odpowiada wiadomościami tekstowymi na podstawie Twoich poleceń, na przykład „OK, włączam światło”. Więcej informacji znajdziesz w artykule Korzystanie z Symulatora Asystenta Google.
Wyrażenia zbiorcze
Aby przetestować integrację z Google Home, możesz wysłać zbiorcze wypowiedzi do Symulacji Asystenta Google, uruchamiając skrypt wypowiedzi. Więcej informacji znajdziesz w artykule Wykonywanie zbiorczych wypowiedzi.
Narzędzia do rejestrowania Matter
Narzędzia do rejestrowania Matter mogą zbierać wszystkie dzienniki związane z debugowaniem Matter, w tym dzienniki Google Home app (GHA) i Usługi Google Play (GMS Core). Logi można wyświetlić w VS Code za pomocą filtrów i wyszukiwania słów kluczowych. Logi można pobrać z dodatkowymi informacjami debugowania, takimi jak Android i wersja aplikacji, i przesłać do Google w celu zgłoszenia problemów.
Cloud Logging
Cloud Logging pokazuje informacje o debugowaniu i kluczowe dane, które ułatwiają analizowanie sposobu korzystania z Action. Aby uprościć proces tworzenia, Google Home Extension wyświetla w czasie rzeczywistym wiadomości Google Cloud Logging tuż obok kodu podczas rozwiązywania problemów. Więcej informacji znajdziesz w artykule Wyświetlanie Cloud Logging.
Wyświetlający panel Home Graph
Wyświetlacz Home Graph jest teraz dostępny bezpośrednio w Google Home Extension, dzięki czemu możesz sprawdzić stan urządzenia w Twoim Home Graph w VS Code. Więcej informacji znajdziesz w artykule Wyświetlanie wykresu głównego i uruchamianie testów.
Instalowanie rozszerzenia Google Home w VS Code
Aby zainstalować Google Home Extension, wykonaj te czynności w VS Code:
- Na pasku aktywności kliknij ikonę Rozszerzenia.
Wyszukaj
google home, a potem kliknij Zainstaluj.
Możesz też pobrać Google Home Extension bezpośrednio z Marketplace VS Code.
Konfigurowanie rozszerzenia Google Home w VS Code
Po zainstalowaniu rozszerzenia Google Home Extension i ponowym uruchomieniu VS Code musisz się zalogować i wybrać projekt, aby móc korzystać z Assistant Simulator i wyświetlać logi Cloud Logging.
Zaloguj się przez Google i wybierz projekt w chmurze
Możesz zalogować się na swoje konto dewelopera z poziomu Google Home Extension, autoryzując VS Code do komunikacji z usługami Google w Twoim imieniu.
Kliknij ikonę Google Home na pasku aktywności, aby otworzyć Google Home Extension.
Kliknij Zaloguj się przez Google, aby otworzyć widok logowania w przeglądarce.
Wybierz konto połączone z urządzeniami inteligentnego domu.
Na stronie autoryzacji Zaloguj się przez Google kliknij Zezwól.
Otworzy się karta przeglądarki i okno Otwórz Visual Studio Code. Aby kontynuować, kliknij Otwórz Visual Studio Code.
Zostaniesz przekierowany do VS Code, gdzie będziesz musiał(-a) wyrazić zgodę na otwarcie identyfikatora URI przez rozszerzenie Google Home. Aby zakończyć proces logowania, kliknij Otwórz.
Po zalogowaniu się Google Home Extension wczyta Twoje projekty. Gdy to zrobisz, kliknij Wybierz projekt.
W wyświetlonym oknie Szukaj i wybierz projekt kliknij projekt inteligentnego domu.
Instalowanie narzędzia Android Debug Bridge (ADB)
Aby wyświetlić dzienniki Matter na telefonie Android, musisz zainstalować ADB:
- Zainstaluj ADB na komputerze.
- Włącz Opcje programisty i Debugowanie USB na telefonie z Androidem.
Instalowanie narzędzi SoC urządzeń Matter
Aby wyświetlić dzienniki debugowania z urządzeń Matter:
- Większość układów SoC eksportuje porty szeregowe, takie jak
/dev/ttyUSBxw Linuxie lub/dev/tty.SLAB_USBtoUARTlub/dev/tty.usbserialw MacOS. Narzędzie LogViewer może odczytać dziennik bezpośrednio z urządzenia. - Niektóre typy SoC, takie jak NXP czy Silicon Labs, mogą wymagać zainstalowania zewnętrznych narzędzi (np. JLink). Więcej informacji znajdziesz w sekcji Obsługiwane urządzenia.
Korzystanie z rozszerzenia Google Home w VS Code
Wyświetlanie zasobów dla deweloperów
W sekcji POMOC I OPINIE kliknij Rozpocznij i zasoby, aby otworzyć stronę Zasoby, na której znajdziesz przydatne informacje dotyczące tworzenia aplikacji w ekosystemie Google Home.
Korzystanie z symulatora Asystenta Google
Aby otworzyć Assistant Simulator w VS Code, na pasku bocznym kliknij GOOGLE ASSISTANT
SIMULATOR. W polu Wiadomość wpisz zapytanie i naciśnij Enter.
Możesz wyświetlić Assistant Simulator odpowiedzi i kliknąć przycisk Wyślij ponownie po zapytaniu.
Uruchamianie zbiorczych wypowiedzi
Przesuń kursor na pasek menu SYMULATOR ASystenta Google i wybierz jedną z tych opcji, aby skonfigurować skrypty:
Kliknij , aby otworzyć istniejące skrypty wypowiedzi.
Aby zapisać historię w skrypcie
*.utterance, kliknij .
Aby rozpocząć wysyłanie zbiorczych wypowiedzi, wybierz jedną z tych opcji:
- Kliknij , aby w menu wybrać skrypt wypowiedzi.
Otwórz bezpośrednio plik
*.utterancei kliknij .
Wyświetlanie Cloud Logging
W sekcji SZYBKI DOSTĘP kliknij Dzienniki Cloud, aby otworzyć stronę Dzienniki Cloud, na której znajdziesz dzienniki należące do wybranego projektu.
Użytkownicy mogą filtrować dzienniki według poziomu ważności i zakresu czasowego.
Domyślnie dzienniki są ograniczone do 50 wierszy. Jeśli użytkownik chce wyświetlić więcej logów, przewiń w dół i kliknij Więcej, aby wyświetlić więcej logów.
Wyświetlanie wykresu strony głównej i uruchamianie testów
W sekcji SZYBKI DOSTĘP kliknij Domowy podgląd grafu, aby otworzyć panel Domowy podgląd grafu, w którym możesz znaleźć urządzenia należące do wybranego projektu. Możesz też kliknąć Uruchom test, aby przeprowadzić testy urządzenia.
Spowoduje to uruchomienie w przeglądarce zestawu testów z wybranym urządzeniem i gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.
Po zakończeniu wszystkich testów możesz sprawdzić ich szczegóły i przeglądać dzienniki.
Debugowanie Matter za pomocą rozszerzenia Google Home
Rejestrowanie w Androidzie
W sekcji NARZĘDZIA DO ZAPISYWANIA INFORMACJI kliknij Android Dzienniki, aby otworzyć stronę Android Dzienniki, wybrać telefon Android, z którym chcesz się połączyć, i wyświetlić dzienniki.
Po połączeniu telefonu Android będziesz mieć możliwość wyświetlania dzienników wiersz po wierszu. Pamiętaj, że logi są filtrowane, co oznacza, że wyświetlane są tylko logi związane z modułem GHA i Google Play servicesMatter. Możesz też ustawić poziom ważności, aby filtrować dzienniki, lub wykonać wyszukiwanie słowa kluczowego w dziennikach.
Logowanie urządzenia Matter
W sekcji NARZĘDZIA DO ZAPISYWANIA INFORMACJI kliknij Dzienniki urządzenia, aby otworzyć stronę Zasoby. Najpierw wybierz Typ SoC:
Następnie wybierz Urządzenie Matter:
Następnie możesz pobrać wszystkie dzienniki urządzenia i użyć filtrów, takich jak Poważność i Wyszukiwanie, aby znaleźć interesujące Cię informacje.
Pobieranie wszystkich dzienników sprawy
W sekcji SZYBKI DOSTĘP kliknij Pobierz dzienniki, aby otworzyć okno Pobierz dzienniki, wybrać dzienniki do pobrania i kliknąć OK.
Wybierz folder, do którego mają zostać pobrane dzienniki, i kliknij Zapisz:
Następnie dzienniki zostaną zapisane w folderze docelowym:
Wyodrębnij zapisany plik ZIP. Zawiera on informacje o urządzeniu i pliki dziennika.
Plik z informacjami o urządzeniu będzie zawierać wszystkie informacje o wersji potrzebne do debugowania problemów.
Prześlij opinię
Aby przesłać swoje opinie na temat tego, jak możemy ulepszyć proces tworzenia aplikacji za pomocą Google Home Extension, wybierz jedną z tych opcji:
- W panelu POMOC I OPINIE kliknij Prześlij opinię, aby przekazać nam swoje sugestie.
- W panelu POMOC I OPINIE kliknij Zgłoś problem, aby zgłosić dowolny problem z Google Home Extension.
- Ikona opinii znajduje się też na stronie Materiały.