Google Home Test Suite,

Google Home Test Suite is a web application that allows you to self-test your smart home Action. The Test Suite automatically generates and runs test cases based on the devices and traits associated with your account. When you complete the tests, you can view the test results or fill in the submission form to submit the test results to Google.

Testy wykonywane przez Test Suite to między innymi:

• Sprawdza, czy na urządzeniach i cechach zaimplementowano stan raportu i prośbę o synchronizację.

• Sprawdza, czy intencja QUERY została zaimplementowana na urządzeniu, a jej wyniki pasują do wyników w raporcie.

Narzędzie Test Suite możesz uruchomić, klikając przycisk poniżej:

Uruchom Test Suite

Przetestuj działanie akcji

W tej sekcji opisujemy, jak uruchomić komponent Test Suite na urządzeniu i w projekcie inteligentnego domu. Test Suite wymaga zalogowania się na konto, aby można było sprawdzić urządzenia w: Google Home Graph and send commands directly to Google Assistant.

Aby przetestować swoje działanie, wykonaj te czynności:

1. Otwórz Test Suite w przeglądarce.

2. Zaloguj się w Google za pomocą przycisku w prawym górnym rogu.

3. Skonfiguruj Szczegóły projektu:

   1. W polu Identyfikator projektu wpisz identyfikator projektu działania Smart Home.
   2. Kliknij Dalej.

4. Skonfiguruj ustawienia testowe:

   1. Jeśli chcesz potwierdzać inteligentne działanie, nie zmieniaj wartości Stan raportu/Czas oczekiwania na synchronizację. Jednak na potrzeby testów możesz zmienić wartość limitu czasu, jeśli agent potrzebuje więcej czasu, aby zgłosić zdarzenie do Home Graph.

   2. Jeśli certyfikujesz inteligentną akcję domową, sprawdź, czy opcja Test Sync Sync jest włączona. Podczas testowania pojawi się prośba o dodanie, zaktualizowanie lub usunięcie urządzenia oraz sprawdzenie, czy lista urządzeń zmieniła się na wykresie głównym. Zmiany są wprowadzane za pomocą testowanej integracji. Integracja w trakcie testu musi zawsze mieć co najmniej 1 urządzenie podłączone do użytkownika agenta.

      ).

   3. Jeśli korzystasz z funkcji Scena, wybierz Test scene tr.

   4. Jeśli przeprowadzasz pakiet testowy na urządzeniach Home Home, wybierz Obsługuje pakiet SDK Home Home.

      1. Wybierz Lokalna realizacja lub Płynna konfiguracja.
      2. Jeśli urządzenie może obsługiwać intencję QUERY, kliknij Obsługuje zapytania lokalne.

5. Wykonaj test i wyświetl wyniki:

   1. Kliknij Dalej, aby rozpocząć testy. Interfejs pokazuje urządzenia i cechy, które są testowane.

6. Wyświetl stronę Wyniki i przesyłanie:

   1. Po zakończeniu testów kliknij Dalej, aby wyświetlić wyniki.

Wyniki testu obejmują liczbę zdanych i niezaliczonych testów oraz końcowy wynik, który wskazuje odsetek zaliczonych testów.

Test weryfikacji połączenia konta

Łączenie kont odgrywa ważną rolę w ekosystemie inteligentnego domu Google. Test weryfikacji połączenia konta w aplikacji Test Suite sprawdza usługę OAuth pod kątem potencjalnych problemów.

Test weryfikacji połączenia konta zawiera testy, które pozwalają zweryfikować tokeny dostępu i tokeny odświeżania:

Test weryfikacji tokena dostępu

Tokeny dostępu zwracane z punktu końcowego wymiany tokenów są testowane w celu sprawdzenia, czy mają prawidłowy format i są zwracane z prawidłowym tokenem odświeżania.

Elementy do testowania	Objaśnienie
Sprawdzanie, czy token dostępu jest w formacie JWT	Łączenie kont Google nie zaleca stosowania tokenów dostępu do formatu tokena JWT. Jeśli format JWT zostanie znaleziony, wyświetli się to ostrzeżenie: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Sprawdź, czy token dostępu z nieaktualnym dostępem ma token odświeżania.	Jeśli token dostępu jest nieważny, musisz podać token odświeżania. Jeśli nie uda się znaleźć tokena odświeżania, ten test się nie powiedzie.

Odśwież test weryfikacji tokena

Tokeny odświeżania są testowane, by punkt końcowy wymiany tokenów prawidłowo wymieniał je na nowe tokeny dostępu.

Elementy do testowania	Objaśnienie
Odśwież token z nieprawidłowym tokenem odświeżania, sprawdzając odpowiedź partnera.	Twój serwer powinien zwrócić błąd HTTP 400 w związku z nieprawidłowym żądaniem {"error": "invalid_grant"} w odpowiedzi na nieprawidłowe żądanie tokena odświeżania. Jeśli odpowiedź nie pasuje do „kodu błędu lub komunikatu”, ten przypadek testowy się nie powiedzie. Więcej informacji znajdziesz na stronie o tokenach odświeżania wymiany w przypadku tokenów dostępu.
Sprawdź, czy token dostępu został zaktualizowany po odświeżeniu tokena.	Nowe tokeny dostępu powinny być zwracane w odpowiedzi na żądania tokenów tokenów. Jeśli Twój serwer udostępnia ten sam token dostępu, instancja testowa zakończy się niepowodzeniem.
Sprawdź, czy token dostępu jest nadal ważny.	Wyświetli się czas wygaśnięcia tokena dostępu.
Sprawdź, czy token odświeżania został obrócony podczas odświeżania.	Sprawdzamy, czy po odświeżeniu tokenu odświeżania zmieniono tokeny odświeżania. Jeśli token odświeżania ulegnie zmianie, serwer powinien unieważnić stary token odświeżania dopiero po użyciu nowego tokena odświeżania, aby uniknąć warunków wyścigu, które mogą zakłócić łączenie kont użytkownika. Test się nie powiedzie, jeśli unieważnisz stary token odświeżania przed użyciem nowego.

Komunikaty o błędach

W tabeli poniżej znajdziesz kilka typowych komunikatów o błędach i sugerowane sposoby ich rozwiązania.

Komunikat o błędzie	Jak rozwiązać problem
Interfejs HomeGraph API nie był wcześniej używany w projekcie <_id_> lub jest wyłączony	Sprawdź, czy włączono HomeGraph API.
Nie znaleziono żądanego elementu	Sprawdź, czy agentUserId jest prawidłowy i czy jest połączony z Twoją usługą.
Sprawdź, czy masz uprawnienie resourcemanager.projects.get w projekcie ${your project id} i czy masz wszystkie uprawnienia na ekranie zgody. Błąd podczas pobierania danych modułu: błąd getModuleData: odpowiedź dotycząca błędu HTTP. Adres URL https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Wykonaj czynności opisane w artykule Rozwiązywanie problemów z uprawnieniami, aby upewnić się, że Twoje konto ma uprawnienia resourcemanager.projects.get w projekcie. Otwórz stronę Aplikacje, które mają dostęp do Twojego konta, aby sprawdzić te uprawnienia aplikacji „Pakiet testowy inteligentnego domu”: Podstawowe informacje o koncie Wyświetlanie podstawowego adresu e-mail Twojego konta Google Wyświetlanie Twoich danych osobowych, w tym udostępnionych przez Ciebie publicznie Dodatkowy dostęp Użyj konta Assistant: szeroki dostęp do konta Google Sprawdzanie inteligentnych urządzeń domowych w Twoim Home Graph i sterowanie nimi Jeśli zobaczysz komunikat o błędzie związanym z uprawnieniami, najpierw usuń dostęp i przyznaj wszystkie uprawnienia na ekranie zgody.

Prześlij wyniki testu

Twoje wyniki w Test Suite muszą przejść 100% testów, zanim prześlesz formularz certyfikacji. Jeśli masz jakiekolwiek cechy wymagające ręcznego testowania, uruchom narzędzie Test Suite i dołącz wynik, nawet jeśli nie został osiągnięty 100%.

Aby przesłać wyniki testów i zatwierdzić działanie inteligentnego domu, wykonaj te czynności:

1. Gdy otrzymasz wyniki testu i chcesz zatwierdzić działanie inteligentnego działania w domu, kliknij Prześlij w narzędziu Test Suite.
2. Kliknij przycisk POBIERZ WYNIKI TESTU.
3. Kliknij PRZEJDŹ DO FORMULARZA PRZESŁANIA, aby przesłać wyniki testu do Google.

4. Wypełnij wszystkie wymagane pola i kliknij Prześlij.