Matter Chmura–chmura Pakiet SDK Local Home
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świetlać 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 zawiera informacje o debugowaniu i kluczowe dane, które ułatwiają analizowanie sposobu korzystania z Action. Aby ułatwić Ci tworzenie aplikacji, 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 Context 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 skończysz, kliknij Wybierz projekt.
W wyświetlonym oknie Szukaj i wybierz projekt kliknij Wybierz projekt.
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 urządzeń wyeksportuje porty szeregowe, takie jak
/dev/ttyUSBx
w systemie Linux lub/dev/tty.SLAB_USBtoUART
lub/dev/tty.usbserial
w systemie 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 Zacznij korzystać z Google Home i zasoby, aby otworzyć stronę Zasoby, na której znajdziesz przydatne informacje o programowaniu 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 SYMULATORA ASISTENTA 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
*.utterance
i 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ń stronę 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 pakietu testów z wybranym urządzeniem gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.
Po zakończeniu wszystkich testów możesz sprawdzić ich szczegóły i otwarte logi.

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 rozpocząć wyświetlanie dzienników.

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. Wybierz dzienniki do pobrania i kliknij 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.

- Na stronie Materiały znajdziesz też ikonę opinii.