Rozszerzenie Google Home dla VS Code

Matter    Cloud-to-cloud    Local Home SDK    Urządzenie SDK

Aplikacja Google Home Extension for Visual Studio Code została opracowana z myślą o deweloperach Google Home Platform. Dzięki temu rozszerzeniu masz dostęp do narzędzi Google Assistant Simulator, Google Cloud Logging, Home Graph i innych narzędzi, które upraszczają proces programowania w standardzie Matter i Inteligentny dom.

Rozszerzenie Google Home dla kodu VS

Funkcje rozszerzeń Google Home

Symulator Asystenta Google

Aby sprawdzić, czy inteligentne urządzenia domowe współpracują z ekosystemem Google Home, możesz w każdej chwili wejść w interakcję z systemem Assistant Simulator bez opuszczania VS Code.

Podobnie jak istniejący symulator z Actions Console, Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wprowadzanie zapytań, na przykład „Włącz światło”. Wewnątrz VS Code Assistant Simulator odpowiada, wysyłając SMS-y na podstawie Twoich poleceń, na przykład „OK, włączam światło”. Więcej informacji znajdziesz w artykule Korzystanie z symulatora Asystenta Google.

Wystąpienia zbiorcze

Aby przetestować integrację Google Home jak automat, możesz wysyłać skrypty zbiorcze do symulatora Asystenta Google, uruchamiając skrypt wypowiedzi. Więcej informacji znajdziesz w sekcji Uruchamianie komunikatów zbiorczych.

Narzędzia do rejestrowania spraw

Narzędzia Matter Logging mogą zbierać wszystkie logi związane z debugowaniem, łącznie z dziennikami Google Home app (GHA) i Usługami Google Play (GMS Core). Logi można wyświetlać w VS Code z wyszukiwaniem i filtrem słów kluczowych. Logi można pobrać razem z dodatkowymi informacjami o debugowaniu, takimi jak Android i wersja aplikacji, oraz przesyłać je do Google w celu zgłaszania problemów.

Logowanie do rozszerzeń Google Home

Cloud Logging

Cloud Logging zapewnia informacje debugowania i kluczowe dane, które dają wgląd w wykorzystanie akcji. Aby uprościć programowanie, podczas rozwiązywania problemów Google Home Extension pokazuje komunikaty Google Cloud Logging w czasie rzeczywistym. Więcej informacji znajdziesz w artykule Wyświetlanie Cloud Logging.

Wyświetlający Home Graph

Podgląd wykresu z Home Home jest teraz dostępny bezpośrednio w Google Home Extension, dzięki czemu możesz zweryfikować stan urządzenia w Home Graph w kodzie VS. Więcej informacji znajdziesz w artykule Wyświetlanie wykresu głównego i testów.

Zainstaluj rozszerzenie Google Home dla VS Code

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

  1. Kliknij ikonę Rozszerzenia na pasku aktywności.
  2. Wyszukaj google home, a następnie kliknij Zainstaluj.

    Rozszerzenie Google Home Marketplace

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

Pobierz Google Home Extension

Skonfiguruj rozszerzenie Google Home dla kodu VS

Gdy zainstalujesz Google Home Extension i załadujesz VS Code jeszcze raz, musisz zalogować się i wybrać projekt, żeby móc używać Assistant Simulator i wyświetlać Cloud Logging.

Zaloguj się przez Google i wybierz projekt w chmurze

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

  1. Kliknij ikonę Google Home na pasku aktywności, aby otworzyć Google Home Extension.

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

    Logowanie w Google Code
  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 wyświetli się okno Otwórz kod ze Studio. Aby kontynuować, kliknij Otwórz kod Studio.

    Otwórz okno dialogowe VS Code
  6. Przekierujemy Cię do kodu VS, w którym Twoje pozwolenie na udostępnienie identyfikatora URI rozszerzenia Google Home jest wymagane. Kliknij Otwórz, aby zakończyć proces logowania.

    Zezwalaj rozszerzeniu Google Home na otwieranie identyfikatora URI
  7. Gdy się zalogujesz, Google Home Extension wczyta Twoje projekty. Gdy skończysz, kliknij Wybierz projekt.

    Wybierz projekt
  8. W wyświetlonym oknie Wyszukaj i wybierz projekt wybierz inteligentny projekt domowy.

Instalowanie narzędzia Android Debug Bridge (ADB)

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

  1. Zainstaluj ADB na komputerze.
  2. Na telefonie z Androidem włącz Opcje programisty i debugowanie USB.

Zainstaluj narzędzia SOC Matter

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

  1. Większość urządzeń SoC pozwala eksportować porty szeregowe urządzenia, takie jak /dev/ttyUSBx w systemie Linux, /dev/tty.SLAB_USBtoUART czy /dev/tty.usbserial w systemie macOS. LogViewer może odczytywać dziennik bezpośrednio z urządzenia.
  2. Niektóre typy SOC, takie jak NXP czy Silicon Labs, mogą wymagać zainstalowania narzędzi zewnętrznych (na przykład JLink). Więcej informacji znajdziesz w sekcji na temat obsługiwanych urządzeń.

Użyj rozszerzenia Google Home dla VS Code

Wyświetl zasoby dla programistów

W sekcji POMOC I OPINIA kliknij Rozpocznij, aby otworzyć stronę Zasoby, na której znajdziesz przydatne informacje o rozwoju ekosystemu Google Home.

Zasoby dla ekosystemu Google Home

Korzystanie z symulatora Asystenta Google

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

Możesz wyświetlić odpowiedzi Assistant Simulator i kliknąć przycisk po wysłaniu zapytania, aby wysłać ponownie.

Korzystanie z symulatora Asystenta Google

Uruchom wyrażenia wsadowe

Najedź kursorem na pasek menu ASSISTANT SIMULATOR i wybierz jedną z tych opcji konfiguracji skryptów:

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

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

    Ikony menu wyrażeń zbiorczych

Aby rozpocząć wysyłanie wyrażeń zbiorczych, wybierz jedną z następujących opcji:

  • Kliknij , aby wybrać skrypt wypowiedzi z menu.
  • Otwórz plik *.utterance i kliknij .

    Ikona uruchomienia operacji zbiorczych

Wyświetl Cloud Logging

W sekcji SZYBKI dostęp kliknij Logi Cloud, aby otworzyć stronę Logi Cloud, na której znajdziesz logi należące do wybranego projektu.

Korzystanie z Cloud Logging

Użytkownicy mogą filtrować logi według wagi i zakresu czasu.

Filtruj logi według poziomu ważności i czasu

Domyślnie dzienniki mogą zawierać maksymalnie 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świetl więcej logów

Wyświetl wykres domowy i przeprowadź testy

W sekcji SZYBKI dostęp kliknij Podgląd wykresu Home, aby otworzyć panel Główny wykres, w którym możesz znaleźć 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 w przeglądarce pakietu testowego z wybranym urządzeniem i gotowością do testów. Kliknij Rozpocznij i poczekaj na wyniki testu.

Pakiet testowy Google Home

Możesz sprawdzić szczegóły testu i wyświetlić logi po zakończeniu wszystkich testów.

Wyniki testów

Używanie rozszerzenia Google Home do debugowania problemów

Logowanie w Androidzie

W sekcji NARZĘDZIA NARZĘDZIA DO LOGOWANIA kliknij Android Logi, aby otworzyć stronę Logi Android, wybierz telefon Android, z którym chcesz się połączyć, i zacznij wyświetlać logi.

Logowanie w Androidzie

Po połączeniu telefonu z systemem Android logi będą widoczne po wierszu. Pamiętaj, że logi są filtrowane, co oznacza, że wyświetlane są tylko logi powiązane z modułem GHA i modułem Google Play services Matter. Możesz też ustawić wagę ważności, aby filtrować logi, lub wyszukać słowo kluczowe.

Logowanie w Androidzie

Rejestrowanie urządzeń Matter

W sekcji NARZĘDZIA NARZĘDZIA DO LOGOWANIA kliknij Dzienniki urządzeń, aby otworzyć stronę Zasoby, a następnie wybierz Typ układu SOC:

Rejestrowanie urządzeń Matter

Następnie wybierz Urządzenie Matter:

Wybór urządzenia Matter

Następnie możesz pobrać wszystkie dzienniki z urządzenia i użyć filtrów, takich jak Waga lub Wyszukiwarka, aby znaleźć interesujące Cię informacje.

Filtrowanie urządzeń Matter

Pobierz wszystkie Matter

W sekcji SZYBKI dostęp kliknij Pobierz logi, aby otworzyć okno Pobieranie logów, wybierz logi do pobrania i kliknij OK.

Pobieranie Matter

Wybierz folder, aby pobrać dzienniki, i kliknij Save (Zapisz):

Zapisz Matter

Następnie logi zostaną zapisane w folderze docelowym:

Folder docelowy logu instancji Matter

Wyodrębnij zapisany plik ZIP, który zawiera informacje o urządzeniach i pliki dziennika.

Plik ZIP z dziennikiem Matter

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

Debugowanie logu instancji

Prześlij opinię

Jeśli chcesz podzielić się swoimi uwagami lub uwagami na temat tego, jak możemy ulepszyć usługę Google Home Extension, wybierz jedną z tych opcji:

  • W panelu POMOC I PRZEŚLIJ OPINIĘ kliknij Prześlij opinię, aby przekazać nam sugestie.
  • W panelu Pomoc i informacje zwrotne kliknij Zgłoś problem, aby zgłosić każdy problem z Google Home Extension
Ikona Prześlij opinię
  • Przesłaliśmy też ikonę opinii na stronie Zasoby.