Matter Chmura–chmura Pakiet SDK Local Home Pakiet SDK urządzenia
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ą proces Matter i tworzenia inteligentnych urządzeń domowych.
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 sekcji 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 pokazuje 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 z 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 Home 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 Google Home Extension i ponownym załadowaniu VS Code musisz zalogować się i wybrać projekt, aby móc używać Assistant Simulator i wyświetlać logi Cloud.
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/ttyUSBxw systemie Linux lub/dev/tty.SLAB_USBtoUARTlub/dev/tty.usbserialw 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 ASystenta 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
*.utterancei 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 głównego i przeprowadzanie 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 otrzeć 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ć wagę, aby filtrować dzienniki, lub wyszukiwać słowo kluczowe w logach.
Logowanie urządzenia Matter
W sekcji NARZĘDZIA DO ZAPISYWANIA INFORMACJI kliknij Logi 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 Pobieranie dzienników, wybrać dzienniki do pobrania i kliknąć 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 usługą Google Home Extension.
- Ikona opinii znajduje się też na stronie Materiały.