Rozszerzenie Google Home dla VS Code

Sprawa    Cloud-to-cloud    Pakiet SDK Local Home    Pakiet SDK urządzenia

Usługa Google Home Extension for Visual Studio Code została zaprojektowana i stworzona z myślą o programistach Google Home Platform. To rozszerzenie daje dostęp do usług Google Assistant Simulator, Google Cloud Logging, przeglądarki Home Graph i innych narzędzi, które ułatwiają zaprogramowanie spraw i inteligentnych domów.

Rozszerzenie Google Home dla VS Code

Funkcje rozszerzeń Google Home

Symulator Asystenta Google

Aby sprawdzić, czy Twoje inteligentne urządzenia domowe działają prawidłowo z ekosystemem Google Home, w każdej chwili możesz wchodzić w interakcję z usługą Assistant Simulator bez opuszczania VS Code.

Podobnie jak w przypadku dotychczasowego symulatora dostępnego w Konsoli Actions, Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, na przykład „Włącz światło”. W sekcji VS Code Assistant Simulator odpowiada SMS-om na podstawie Twoich poleceń, na przykład: „OK, włączam światło”. Więcej informacji znajdziesz w artykule Używanie symulatora Asystenta Google.

Wyrażenia zbiorcze

Aby przetestować integrację z Google Home (na przykład jak automaty), możesz wysyłać wyrażenia zbiorcze do symulatora Asystenta Google, uruchamiając skrypt wypowiedzi. Więcej informacji znajdziesz w artykule Uruchamianie wyrażeń wsadowych.

Narzędzia do zapisywania spraw

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

Logowanie spraw do rozszerzenia Google Home

Cloud Logging

Narzędzie Cloud Logging zawiera informacje na temat debugowania i kluczowe dane, dzięki którym możesz dowiedzieć się więcej o wykorzystaniu działania. Aby uprościć programowanie, podczas rozwiązywania problemów Google Home Extension wyświetla komunikaty Google Cloud Logging w czasie rzeczywistym obok kodu. Więcej informacji znajdziesz w artykule Wyświetlanie Cloud Logging.

Wyświetlający Home Graph

Funkcja Home Graph jest teraz dostępna bezpośrednio w Google Home Extension. Dzięki temu możesz sprawdzać stan urządzenia w Home Graph w kodzie VS Code. Więcej informacji znajdziesz w sekcji Wyświetlanie głównego wykresu i uruchamianie testów.

Zainstaluj rozszerzenie Google Home dla VS Code

Aby zainstalować Google Home Extension, wykonaj te czynności z poziomu kodu VS:

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

    Rynek rozszerzeń Google Home

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

Pobierz Google Home Extension

Skonfiguruj rozszerzenie Google Home dla VS Code

Po zainstalowaniu pakietu Google Home Extension i ponownym załadowaniu kodu VS Code musisz się zalogować i wybrać projekt, aby móc użyć Assistant Simulator i wyświetlić Cloud Logging.

Zaloguj się przez Google i wybierz projekt w chmurze

Możesz zalogować się na swoje konto dewelopera w aplikacji Google Home Extension, aby zezwolić VS Code na komunikowanie się z usługami Google w Twoim imieniu.

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

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

    VS Code – Logowanie przez 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 okno Open Visual Studio Code. Aby kontynuować, kliknij Otwórz kod Visual Studio.

    Otwórz okno dialogowe VS Code
  6. Nastąpi przekierowanie do strony VS Code, gdzie Twoja zgoda jest wymagana, aby rozszerzenie Google Home mogło otworzyć identyfikator URI. 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 Select a project (Wybierz projekt).

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

Zainstaluj narzędzie 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.

Instalowanie narzędzi SOC urządzenia Matter

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

  1. Większość układów SoC urządzeń eksportuje porty szeregowe, takie jak /dev/ttyUSBx w systemie Linux lub /dev/tty.SLAB_USBtoUART bądź /dev/tty.usbserial w systemie macOS. LogViewer może odczytać dziennik bezpośrednio z urządzenia.
  2. Niektóre typy SOC, takie jak NXP czy Silicon Labs, mogą wymagać zainstalowania narzędzi zewnętrznych (np. JLink). Więcej informacji znajdziesz w sekcji Obsługiwane urządzenia.

Użyj rozszerzenia Google Home dla VS Code

Wyświetl zasoby dla deweloperów

W sekcji POMOC I OPINIA kliknij Pierwsze kroki i zasoby, aby otworzyć stronę Zasoby, na której znajdziesz przydatne informacje związane z tworzeniem ekosystemu Google Home.

Zasoby dotyczące ekosystemu Google Home

Korzystanie z symulatora Asystenta Google

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

Możesz wyświetlić odpowiedzi (Assistant Simulator) i kliknąć przycisk za zapytaniem, aby wysłać je ponownie.

Korzystanie z symulatora Asystenta Google

Uruchamiaj wyrażenia zbiorcze

Najedź kursorem na pasek menu GOOGLE ASSISTANT SIMULATOR 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 zacząć wysyłać zbiorcze wypowiedzi, wybierz jedną z tych opcji:

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

    Ikona uruchomienia wypowiedzi wsadowych

Wyświetl Cloud Logging

W sekcji SZYBKI DOSTĘP kliknij Logi chmury, aby otworzyć stronę Logi Cloud, gdzie znajdziesz logi należące do wybranego projektu.

Użyj Cloud Logging

Użytkownicy mogą filtrować logi na podstawie poziomu ważności i zakresu czasu.

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

Domyślnie logi mają 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 na stronie głównej i uruchom testy

W sekcji SZYBKI DOSTĘP kliknij Podgląd wykresu głównego, aby otworzyć panel Podgląd wykresów domowych, w którym znajdziesz urządzenia należące do wybranego projektu. Możesz też kliknąć Uruchom test, aby uruchomić testy urządzenia.

Wyświetlający Home Graph

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

Pakiet Google Home Test Suite

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 standardu Matter

Logowanie w Androidzie

W sekcji MATTER LOGGING TOOLS (GŁÓWNE NARZĘDZIA DO LOGOWANIA) kliknij Logi Android, 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 operatorem Android zobaczysz logi wiersz po wierszu. Pamiętaj, że logi są filtrowane, co oznacza, że wyświetlają się tylko logi powiązane z GHA i modułem Google Play services Matter. Możesz też ustawić Waga, aby filtrować dzienniki, lub Przeszukać słowo kluczowe w logach.

Odfiltrowane dane logowania Androida

Logowanie urządzenia Matter

W sekcji MATTER LOGGING TOOLS (GŁÓWNE NARZĘDZIA DO LOGOWANIA) kliknij Logi urządzenia, aby otworzyć stronę Zasoby, i najpierw wybierz Typ SOC:

Logowanie urządzenia Matter

Następnie wybierz Urządzenie sprawy:

Wybór urządzenia do logowania urządzenia Matter

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

Logowanie filtrowane na urządzeniach Matter

Pobierz wszystkie dzienniki spraw

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

Pobieranie dzienników spraw

Wybierz folder, w którym chcesz pobrać dzienniki, i kliknij Save (Zapisz):

Zapisywanie dziennika sprawy

Dzienniki zostaną zapisane w folderze docelowym:

Folder docelowy dziennika Matter

Wyodrębnij zapisany plik ZIP. Zostaną wyświetlone informacje o urządzeniu i pliki dziennika.

Plik ZIP dziennika sprawy

Plik z informacjami o urządzeniach będzie zawierał wszystkie informacje o wersji niezbędne do debugowania problemów.

Debugowanie dziennika sprawy

Prześlij opinię

Aby przesłać opinię lub opinię na temat tego, jak możemy ulepszyć środowisko programistyczne Google Home Extension, wybierz jedną z tych opcji:

  • W panelu POMOC I OPINIA kliknij Prześlij opinię, by przekazać nam swoje sugestie.
  • W panelu POMOC I OPINIA kliknij Zgłoś problem, aby zgłosić problem związany z usługą Google Home Extension.
Ikona przesyłania opinii
  • Umieściliśmy też ikonę opinii na stronie Zasoby.