Rozszerzenie Google Home dla VS Code

Sprawa    Z chmury do chmury    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 korzystających z 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ą proces tworzenia spraw i inteligentnych domów.

Rozszerzenie Google Home dla VS Code

Funkcje rozszerzenia Google Home

Symulator Asystenta Google

Aby sprawdzić, czy inteligentne urządzenia domowe działają prawidłowo z ekosystemem Google Home, możesz w każdej chwili wejść 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 „„Turn on the light” (Włącz światło). W aplikacji VS Code Assistant Simulator odpowiada SMS-om na podstawie Twoich poleceń, takich jak „Dobrze, włączam światło”. Więcej informacji znajdziesz w artykule Korzystanie z symulatora Asystenta Google.

Wypowiedzi wsadowe

Aby przetestować integrację z Google Home, tak jak w przypadku automatyki, możesz wysyłać zbiorcze wypowiedzi do symulatora Asystenta Google, uruchamiając skrypt wypowiedzi. Więcej informacji znajdziesz w artykule Uruchamianie wyrażeń zbiorczych.

Narzędzia do zapisywania spraw

Narzędzia do logowania Matter mogą gromadzić wszystkie logi związane z debugowaniem Matter, w tym logi Google Home app (GHA) i usługi Google Play (GMS Core). Dzienniki można wyświetlać w aplikacji VS Code z użyciem filtrów i wyszukiwań słów kluczowych. Logi można pobierać z dodatkowymi informacjami na temat debugowania, takimi jak Android i wersja aplikacji, oraz wysyłać je do Google, aby zgłaszać problemy.

Logowanie sprawy do rozszerzenia Google Home

Cloud Logging

Raport Cloud Logging zawiera informacje na potrzeby debugowania i kluczowe dane, które dają wgląd w użycie akcji. Aby ułatwić programowanie, Google Home Extension wyświetla komunikaty Google Cloud Logging w czasie rzeczywistym obok kodu podczas rozwiązywania problemów. Więcej informacji znajdziesz na stronie Wyświetlanie Cloud Logging.

Wyświetlający Home Graph

Narzędzie Home Graph jest teraz dostępne bezpośrednio w Google Home Extension, dzięki czemu możesz sprawdzać stan urządzenia w Home Graph w kodzie VS. Więcej informacji znajdziesz w sekcji Wyświetlanie Home Graph i wykonywanie 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 aplikację google home, a następnie kliknij Zainstaluj.

    Rynek rozszerzeń Google Home

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

Pobierz Google Home Extension

Skonfiguruj rozszerzenie Google Home dla VS Code

Po zainstalowaniu Google Home Extension i ponownym załadowaniu 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 swoje konto dewelopera z poziomu 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ć widok logowania w przeglądarce.

    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 pojawi się okno Open Visual Studio Code. Aby przejść dalej, kliknij Open Visual Studio Code.

    Otwórz okno VS Code
  6. Przekierujemy Cię do witryny VS Code, gdzie Twoja zgoda jest wymagana, aby zezwolić rozszerzeniu Google Home na otwarcie identyfikatora 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 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 w systemie 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 na urządzeniu 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 czy /dev/tty.usbserial w systemie macOS. LogViewer może odczytać dziennik bezpośrednio z urządzenia.
  2. Niektóre typy SOC, takie jak NXP lub Silicon Labs, mogą wymagać zainstalowania zewnętrznych narzędzi (na przykład JLink). Więcej informacji znajdziesz w sekcji Obsługiwane urządzenia.

Użyj rozszerzenia Google Home dla VS Code

Zobacz zasoby dla deweloperów

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

Materiały dotyczące ekosystemu Google Home

Korzystanie z symulatora Asystenta Google

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

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

Korzystanie z symulatora Asystenta Google

Uruchamiaj wypowiedzi wsadowe

Najedź kursorem na pasek menu SIMULATORA GOOGLE ASSISTANT i wybierz jedną z następujących opcji, aby skonfigurować skrypty:

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

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

    Ikony menu Wypowiedzi wsadowych

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

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

    Ikona uruchamiania wypowiedzi wsadowych

Wyświetl 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.

Użyj Cloud Logging

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

Filtruj logi 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, aby zobaczyć więcej logów.

Wyświetl więcej logów

Wyświetl wykres na stronie głównej i przeprowadź testy

W sekcji SZYBKI DOSTĘP kliknij Podgląd wykresu głównego, aby otworzyć panel Podgląd wykresu głównego, 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 w przeglądarce pakietu testów 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 spraw

Logowanie w Androidzie

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

Przefiltrowane dane z dziennika Android

Rejestrowanie urządzenia Matter

W sekcji MATTER LOGGING TOOLS (Główne narzędzia do rejestrowania danych) kliknij Device Logs (Dzienniki urządzenia), aby otworzyć stronę Resources (Zasoby) i najpierw wybierz SoC Type (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 i użyć filtrów takich jak Waga i Szukaj, aby znaleźć interesujące Cię informacje.

Logowanie filtrowanych urządzeń w standardzie Matter

Pobierz wszystkie dzienniki sprawy

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

Pobierz dzienniki sprawy

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

Zapisywanie dziennika sprawy

Dzienniki zostaną zapisane w folderze docelowym:

Folder docelowy dziennika sprawy

Wyodrębnij zapisany plik ZIP. Wyświetlą się informacje o urządzeniu i pliki dziennika.

Plik ZIP dziennika sprawy

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

Debugowanie dziennika sprawy

Prześlij opinię

Aby przesłać nam swoje uwagi lub opinie na temat tego, jak możemy ulepszyć usługę 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 Google Home Extension.
Ikona przesyłania opinii
  • Na stronie Zasoby umieściliśmy też ikonę opinii.