Google Home Test Suite,

Z chmury do chmury    Pakiet SDK Local Home

Google Home Test Suite to aplikacja internetowa, dzięki której możesz samodzielnie przetestować działanie inteligentnego domu. Test Suite automatycznie generuje i uruchamia przypadki testowe na podstawie urządzeń i cech powiązanych z Twoim kontem. Po zakończeniu testów możesz wyświetlić ich wyniki lub wypełnić formularz zgłoszeniowy i przesłać go do Google.

Testy wykonywane przez Test Suite obejmują m.in.:

• Sprawdza, czy w przypadku Twoich urządzeń i właściwości są wdrożone stan raportu i synchronizacja żądań.

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

.

Aby uruchomić narzędzie Test Suite, kliknij przycisk poniżej:

Uruchom aplikację Test Suite

Przetestuj swoją akcję

W tej sekcji dowiesz się, jak uruchomić Test Suite na urządzeniu i w projekcie Smart Home Action. Aplikacja Test Suite wymaga zalogowania się, by mogła sprawdzać urządzenia w Google Home Graph i wysyłać polecenia bezpośrednio do Google Assistant.

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

1. W przeglądarce otwórz Test Suite.

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 dla akcji dotyczącej inteligentnego domu.
   2. Kliknij Dalej.

4. Skonfiguruj Ustawienia testu:

   1. W przypadku certyfikowania akcji inteligentnego domu nie zmieniaj domyślnej wartości Stan raportu/Czas oczekiwania synchronizacji żądania. Możesz jednak zmienić wartość limitu czasu na potrzeby testów, jeśli agent potrzebuje więcej czasu na przesłanie informacji o stanie do Home Graph.

   2. Jeśli certyfikujesz działanie inteligentnego domu, upewnij się, że jest włączona opcja Test Request Sync (Testuj synchronizację żądania). Podczas testów pojawi się prośba o dodanie, zaktualizowanie lub usunięcie urządzenia oraz sprawdzenie, czy lista urządzeń uległa zmianie w Home Graph. Działania zmiany są podejmowane w ramach testowanej integracji. Testowana integracja musi zawsze mieć co najmniej 1 urządzenie podłączone do użytkownika agenta.

   3. Jeśli używasz cechy Scene, wybierz Testowa cecha.

   4. Jeśli korzystasz z pakietu testowego dla lokalnych urządzeń domowych, wybierz Obsługuje pakiet SDK do lokalnego domu.

      1. Wybierz Local Fulfillment (Lokalna realizacja) lub Seamless Setup (Konfiguracja bezproblemowa).
      2. Kliknij Obsługuje zapytania lokalne, jeśli urządzenie może obsługiwać intencję QUERY lokalnie.

5. Przeprowadź test i wyświetl wyniki:

   1. Kliknij Dalej, aby rozpocząć testy. Interfejs pokazuje urządzenia i cechy poddawane testom.

6. Wyświetl stronę Wyniki i zgłoszenie:

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

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

Test weryfikacji połączenia kont

Łączenie kont odgrywa ważną rolę w ekosystemie inteligentnego domu Google. Test weryfikacji połączenia kont w Test Suite sprawdza, czy w usłudze OAuth nie występują potencjalne problemy.

Test weryfikacji połączenia kont obejmuje testy, które mają na celu sprawdzenie tokenów dostępu i tokenów odświeżania:

Test weryfikacji tokena dostępu

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

Elementy testowe	Wyjaśnienie
Sprawdzanie, czy token dostępu ma format JWT	W przypadku łączenia konta Google nie zaleca się tokenów dostępu w formacie JWT. Jeśli zostanie znaleziony format JWT, pojawi 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 wygasa token dostępu, czy ma token odświeżania.	Gdy token dostępu straci ważność, musisz podać token odświeżania. Ten test się nie powiedzie, jeśli nie zostanie znaleziony token odświeżania.

Odśwież test weryfikacji tokena

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

Elementy testowe	Wyjaśnienie
Odświeżanie tokena z nieprawidłowym tokenem odświeżania, sprawdzanie odpowiedzi partnera.	Twój serwer powinien zwracać błąd HTTP 400 Bad Request z wartością {"error": "invalid_grant"} w przypadku nieprawidłowego żądania tokena odświeżania. Jeśli odpowiedź nie pasuje do „kodu błędu lub komunikatu”, ten przypadek testowy zakończy się niepowodzeniem. Więcej informacji znajdziesz na stronie wymieniania tokenów odświeżania na tokeny dostępu.
Sprawdź, czy po odświeżeniu tokena token dostępu został zaktualizowany.	W odpowiedzi na żądania odświeżania tokenów powinny być zwracane nowe tokeny dostępu. Jeśli serwer udostępnia ten sam token dostępu, przypadek testowy zakończy się niepowodzeniem.
Sprawdź, czy token dostępu, który jeszcze nie wygasł, jest nadal ważny.	Zostanie wyświetlony czas ważności tokena dostępu.
Sprawdź, czy podczas odświeżania token odświeżania został obrócony.	Sprawdzamy, czy tokeny odświeżania zostały zmienione po wysłaniu prośby o token odświeżania. Jeśli token odświeżania się zmieni, serwer powinien unieważnić stary token odświeżania dopiero po użyciu nowego tokena odświeżania, aby zapobiec wyścigom, które mogą unieważnić łą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 niektóre typowe komunikaty o błędach, które możesz napotkać, oraz sugerowane sposoby ich rozwiązania.

Komunikat o błędzie	Jak rozwiązać
Interfejs HomeGraph API nie był wcześniej używany w projekcie <_id_> lub jest wyłączony	Sprawdź, czy masz włączony interfejs HomeGraph API.
Nie znaleziono żądanej jednostki	Sprawdź, czy identyfikator agentUserId jest prawidłowy i jest połączony z Twoją usługą.
Sprawdź, czy masz w projekcie ${your project id} uprawnienie resourcemanager.projects.get i przyznane wszystkie uprawnienia na ekranie akceptacji. Błąd podczas pobierania danych modułu: błąd getModuleData: odpowiedź na błąd HTTP dla https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Wykonaj instrukcje opisane w artykule Rozwiązywanie problemów z uprawnieniami, aby sprawdzić, czy Twoje konto ma uprawnienia resourcemanager.projects.get do projektu. Otwórz stronę Aplikacje, które mają dostęp do Twojego konta, aby sprawdzić te uprawnienia „Pakietu testowego dla inteligentnego domu”: Podstawowe informacje o koncie Wyświetlanie podstawowego adresu e-mail Twojego konta Google Wyświetlanie Twoich danych osobowych, w tym tych udostępnionych przez Ciebie publicznie Dodatkowy dostęp Używaj konta Assistant: szeroki dostęp do konta Google Sprawdzanie inteligentnych urządzeń domowych w Home Graph i sterowanie nimi Jeśli pojawi się błąd dotyczący uprawnień, najpierw odbierz dostęp i przyznaj wszystkie uprawnienia na ekranie akceptacji, gdy zalogujesz się ponownie.

Prześlij wyniki testu

Zanim prześlesz formularz certyfikacyjny, Twoje wyniki w usłudze Test Suite muszą zaliczyć wszystkie testy. Jeśli masz cechy, które wymagają testowania ręcznego, nadal uruchom narzędzie Test Suite i załącz wynik, nawet jeśli nie jest on w 100% poprawny.

Aby przesłać wyniki testu i certyfikować działanie inteligentnego domu, wykonaj te czynności:

1. Gdy otrzymasz wyniki testu i chcesz potwierdzić, że działa inteligentne działanie domu, kliknij Prześlij w narzędziu Test Suite.
2. Aby pobrać wyniki testu, kliknij przycisk POBIERZ WYNIKI TESTU.
3. Kliknij OTWÓRZ FORMULARZ ZGŁOSZENIOWY, aby przesłać wyniki testu do Google.

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