Rozszerzenie Google Home dla VS Code

Google Home Extension for Visual Studio Code zostało zaprojektowane i stworzone z myślą o deweloperach korzystających z Google Home Platform. To rozszerzenie zapewnia dostęp do Google Assistant Simulator, Google Cloud Logging, wyświetlającego Home Graph i innych narzędzi, które upraszczają proces tworzenia Matter i inteligentnego domu.

Rozszerzenie Google Home dla VS Code

Funkcje rozszerzenia Google Home

Symulator Asystenta Google

Aby sprawdzić, czy inteligentne urządzenia domowe działają prawidłowo w ekosystemie Google Home , możesz w każdej chwili korzystać z Assistant Simulator bez opuszczania VS Code.

Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, np. „Włącz światło” W VS Code Assistant Simulator odpowiada wiadomościami tekstowymi na podstawie Twoich poleceń, np. „OK, włączam światło” Więcej informacji znajdziesz w artykule Korzystanie z symulatora Asystenta Google.

Wypowiedzi zbiorcze

Aby przetestować integrację z Google Home jak automat, możesz wysyłać wypowiedzi zbiorcze do symulatora Asystenta Google przez uruchomienie skryptu wypowiedzi. Więcej informacji znajdziesz w artykule Uruchamianie wypowiedzi zbiorczych.

Narzędzia do logowania Matter

Narzędzia do logowania Matter mogą zbierać wszystkie logi związane z Matter debugowaniem, w tym logi Google Home app (GHA) i logi Usług Google Play (GMS Core). Logi można wyświetlać w VS Code z filtrami i wyszukiwaniem słów kluczowych. Logi można pobierać z dodatkowymi informacjami do debugowania, takimi jak Android i wersja aplikacji, i wysyłać do Google w celu zgłaszania problemów.

Rejestrowanie zdarzeń Matter w rozszerzeniu Google Home

Cloud Logging

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 Extension wyświetla w czasie rzeczywistym wiadomości Cloud Logging bezpośrednio obok kodu podczas rozwiązywania problemów. Więcej informacji znajdziesz w artykule Wyświetlanie Cloud Logging.

Wyświetlający Home Graph

Wyświetlający Home Graph jest teraz dostępny bezpośrednio w Google Home Extension dzięki czemu możesz sprawdzić stan urządzenia w Home Graph w VS Code. Więcej informacji znajdziesz w artykule Wyświetlanie Home Graph i przeprowadzanie testów.

Instalowanie rozszerzenia Google Home dla VS Code

Aby zainstalować Google Home Extension, wykonaj te czynności w VS Code:

  1. Na pasku aktywności kliknij ikonę Rozszerzenia.
  2. Wyszukaj google home, a potem kliknij Zainstaluj.

    Google Home Extension Marketplace

Google Home Extension możesz też pobrać bezpośrednio z VS Code Marketplace.

Pobierz Google Home Extension

Konfigurowanie rozszerzenia Google Home dla VS Code

Po zainstalowaniu Google Home Extension i ponownym wczytaniu VS Code musisz się zalogować i wybrać projekt, aby móc korzystać z Assistant Simulator i wyświetlać Cloud Logging.

Zaloguj się przez Google i wybierz projekt w chmurze

Możesz zalogować się na konto dewelopera z poziomu Google Home Extension, autoryzując VS Code do komunikowania się z usługami Google w Twoim imieniu.

  1. Aby otworzyć Google Home Extension, na pasku aktywności kliknij ikonę Google Home.

    Ikona rozszerzenia Google Home
  2. Aby otworzyć widok logowania w przeglądarce, kliknij Zaloguj się przez Google.

    Logowanie w VS Code za pomocą konta Google
  3. Wybierz konto połączone z inteligentnymi urządzeniami domowymi.

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

  5. Otworzy się karta przeglądarki i pojawi się okno Otwórz Visual Studio Code. Aby kontynuować, kliknij Otwórz Visual Studio Code.

    Otwieranie okna VS Code
  6. Nastąpi przekierowanie do VS Code, gdzie musisz zezwolić rozszerzeniu Google Home na otwarcie identyfikatora URI. Aby zakończyć proces logowania, kliknij Otwórz.

    Zezwalanie rozszerzeniu Google Home na otwieranie identyfikatora URI
  7. Po zalogowaniu Google Home Extension wczyta Twoje projekty. Gdy to się stanie, kliknij Wybierz projekt.

    Wybierz projekt
  8. W wyświetlonym menu Wyszukaj i wybierz projekt wybierz projekt inteligentnego domu.

Instalowanie narzędzia Android Debug Bridge (ADB)

Aby wyświetlić logi Matter na telefonie z Android, musisz zainstalować ADB:

  1. Zainstaluj ADB na komputerze.
  2. Włącz na telefonie z Androidem opcje programisty i debugowanie USB.

Instalowanie narzędzi SoC urządzenia Matter

Aby wyświetlić logi debugowania z urządzeń Matter:

  1. Większość układów SoC urządzeń eksportuje porty szeregowe, takie jak /dev/ttyUSBx w systemie Linux lub /dev/tty.SLAB_USBtoUART albo /dev/tty.usbserial w systemie macOS. Przeglądarka logów może odczytywać logi bezpośrednio z urządzenia.
  2. W przypadku niektórych typów układów SoC, takich jak NXP lub Silicon Labs, może być konieczne zainstalowanie narzędzi zewnętrznych (np. JLink). Więcej informacji znajdziesz w artykule Obsługiwane urządzenia.

Korzystanie z rozszerzenia Google Home dla VS Code

Wyświetlanie materiałów dla deweloperów

W sekcji POMOC I OPINIE kliknij Pierwsze kroki i materiały, aby otworzyć stronę Materiały, na której znajdziesz przydatne informacje dotyczące tworzenia w ekekosystemie Google Home.

Materiały dotyczące ekosystemu Google Home

Korzystanie z symulatora Asystenta Google

Aby otworzyć Assistant Simulator w VS Code, na pasku bocznym kliknij SYMULATOR ASYSTENTA GOOGLE. W polu Wiadomość wpisz zapytanie i naciśnij Enter.

Możesz wyświetlać Assistant Simulator odpowiedzi i kliknąć przycisk po zapytaniu, aby je ponownie wysłać.

Korzystanie z symulatora Asystenta Google

Uruchamianie wypowiedzi zbiorczych

Najedź kursorem na pasek menu SYMULATOR ASYSTENTA GOOGLE i wybierz jedną z tych opcji, aby skonfigurować skrypty:

  • Kliknij , aby otworzyć istniejące skrypty wypowiedzi.

  • Kliknij , aby zapisać historię w skrypcie *.utterance.

    Ikony menu wypowiedzi zbiorczych

Aby rozpocząć wysyłanie wypowiedzi zbiorczych, wybierz jedną z tych opcji:

  • Kliknij , aby wybrać skrypt wypowiedzi w menu.
  • Otwórz bezpośrednio plik *.utterance i kliknij .

    Ikona uruchamiania wypowiedzi zbiorczych

Wyświetlanie Cloud Logging

W sekcji SZYBKI DOSTĘP kliknij Logi w chmurze, aby otworzyć stronę Logi w chmurze, na której znajdziesz logi należące do wybranego projektu.

Korzystanie z Cloud Logging

Użytkownicy mogą filtrować logi według poziomu ważności i zakresu czasu.

Filtrowanie logów według poziomu ważności i czasu

Domyślnie logi są ograniczone do 50 wierszy. Jeśli użytkownik chce wyświetlić więcej logów, przewiń w dół i kliknij Więcej.

Wyświetlanie większej liczby logów

Wyświetlanie Home Graph i przeprowadzanie testów

W sekcji SZYBKI DOSTĘP kliknij Wyświetlający Home Graph , aby otworzyć panel Wyświetlający Home Graph , na którym znajdziesz urządzenia należące do wybranego projektu. Możesz też kliknąć Uruchom test , aby przeprowadzić testy urządzenia.

Wyświetlający Home Graph

Spowoduje to uruchomienie zestawu testów w przeglądarce z wybranym urządzeniem gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.

Zestaw testów Google Home

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

Wyniki testów

Korzystanie z rozszerzenia Google Home do debugowania Matter

Logowanie w Androidzie

W sekcji NARZĘDZIA DO LOGOWANIA MATTER kliknij Android Logi, aby otworzyć stronę Android Logi, wybrać Android telefon, z którym chcesz się połączyć, i rozpocząć wyświetlanie logów.

Rejestrowanie w Androidzie

Po połączeniu telefonu Android możesz wyświetlać logi wiersz po wierszu. Pamiętaj, że logi są filtrowane, co oznacza, że wyświetlane są tylko logi związane z GHA i modułem Google Play services Matter. Możesz też ustawić Poziom ważności , aby filtrować logi, lub Wyszukać słowo kluczowe w logach.

Odfiltrowane logowanie w Androidzie

Logowanie urządzenia Matter

W sekcji NARZĘDZIA DO LOGOWANIA MATTER kliknij Logi urządzenia, aby otworzyć stronę Materiały, a następnie wybierz Typ SoC:

Logowanie urządzenia Matter

Następnie wybierz Urządzenie Matter:

Logowanie urządzenia Matter – wybór urządzenia

Następnie możesz pobrać wszystkie logi urządzenia i użyć filtrów, takich jak Poziom ważności i Wyszukaj , aby znaleźć interesujące Cię informacje.

Filtrowane logowanie urządzenia Matter

Pobieranie wszystkich logów Matter

W sekcji SZYBKI DOSTĘP kliknij Pobierz logi , aby otworzyć okno Pobierz logi , wybrać logi do pobrania i kliknąć OK.

Pobieranie logów sprawy

Wybierz folder, do którego chcesz pobrać logi, i kliknij Zapisz:

Zapisywanie dziennika sprawy

Logi zostaną zapisane w folderze docelowym:

Folder docelowy logów sprawy

Wyodrębnij zapisany plik ZIP. Zobaczysz informacje o urządzeniu i pliki logów.

Plik ZIP dziennika sprawy

Plik z informacjami o urządzeniu będzie zawierać wszystkie informacje o wersji potrzebne do debugowania problemów.

Debugowanie dziennika Matter

Przesyłanie opinii

Aby przesłać swoje uwagi lub opinię na temat tego, jak możemy ulepszyć proces tworzenia za pomocą Google Home Extension, wybierz jedną z tych opcji:

  • W panelu POMOC I OPINIE kliknij Prześlij opinię, aby przesłać nam sugestie.
  • W panelu POMOC I OPINIE kliknij Zgłoś problem, aby zgłosić problem znaleziony w Google Home Extension
Ikona Prześlij opinię
  • Na stronie Materiały dodaliśmy też ikonę opinii.