Google Home Test Suite to aplikacja internetowa, która pozwala samodzielnie przetestować akcję 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 przesyłania, aby przesłać wyniki do Google.
Testy wykonywane przez interfejs Test Suite obejmują między innymi:
Sprawdza, czy dla Twoich urządzeń i cech są zaimplementowane Stan raportu i Poproś o synchronizację.
Sprawdza, czy na urządzeniu została wdrożona intencja QUERY, a jej wyniki są zgodne z wynikami raportu Stanu raportu.
Możesz uruchomić narzędzie Test Suite, klikając przycisk poniżej:
Przeprowadź samodzielną ocenę swojej akcji
Z tej sekcji dowiesz się, jak uruchomić aplikację Test Suite na urządzeniu i w projekcie akcji w inteligentnym domu. Test Suitewymaga zalogowania się, aby można było sprawdzić urządzenia wGoogle Home Graph i wysyłać polecenia bezpośrednio do Google Assistant.
Aby samodzielnie przetestować akcję, wykonaj te czynności:
- W przeglądarce otwórz Test Suite.
Zaloguj się w Google za pomocą przycisku w prawym górnym rogu.
Skonfiguruj Szczegóły projektu:
- W polu Identyfikator projektu wpisz identyfikator projektu inteligentnego domu.
- Kliknij Dalej.
Skonfiguruj Ustawienia testu:
- Jeśli certyfikujesz akcję inteligentnego domu, pozostaw domyślną wartość Report State/Request Sync Timeout (Stan raportu / Czas oczekiwania na synchronizację żądania). Możesz jednak zmienić wartość limitu czasu na potrzeby testów, jeśli agent potrzebuje więcej czasu na przekazanie informacji o stanie do Home Graph.
Jeśli przeprowadzasz certyfikację działania inteligentnego domu, upewnij się, że włączona jest opcja Test Request Sync (Testuj prośbę o synchronizację). Podczas testów pojawi się prośba o dodanie, zaktualizowanie lub usunięcie urządzenia i sprawdzenie, czy lista urządzeń zmieniła się w Home Graph. Działania dotyczące zmian są wprowadzane w ramach testowanej integracji. Testowana integracja musi zawsze mieć co najmniej 1 urządzenie podłączone do użytkownika agenta.
Jeśli używasz cechy Scene, wybierz Przetestuj cechę sceny.
Jeśli korzystasz z pakietu testowego pod kątem urządzeń lokalnych w domu, wybierz Obsługuje pakiet SDK dla lokalnej firmy.
- Wybierz Realizacja lokalna lub Łatwa konfiguracja.
- Kliknij Obsługuje zapytania lokalne, jeśli urządzenie może lokalnie obsłużyć intencję QUERY.
Przeprowadź test testowy i sprawdź wyniki:
- Kliknij Dalej, aby rozpocząć testy. Interfejs przedstawia testowane urządzenia i cechy.
Wyświetl stronę Wyniki i przesłanie:
- Po zakończeniu testów kliknij Dalej, aby wyświetlić ich wyniki.
Wyniki testu obejmują liczbę zaliczonych i niezaliczonych testów oraz końcowy wynik wskazujący odsetek zaliczonych testów.
Test weryfikacji łączenia kont
Łączenie kont odgrywa ważną rolę w ekosystemie inteligentnego domu Google. Test poprawności łączenia kont w Test Suite sprawdza, czy usługa OAuth nie zawiera potencjalnych problemów.
Test weryfikacji połączenia kont obejmuje testy umożliwiające weryfikację tokenów dostępu i tokenów odświeżania:
Test weryfikacji tokena dostępu
Tokeny dostępu zwracane z punktu końcowego tokena wymiany tokenów są testowane pod kątem prawidłowego formatu i zwracania z prawidłowym tokenem odświeżania.
Elementy testowe | Wyjaśnienie |
---|---|
Sprawdź, czy token dostępu jest w formacie JWT | W połączeniu z kontem Google nie zaleca się tokenów dostępu w formacie JWT. W przypadku znalezienia formatu 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 wygasający token dostępu ma token odświeżania. | Należy podać token odświeżania, gdy token dostępu wygaśnie. Ten test nie powiedzie się, jeśli nie zostanie znaleziony token odświeżania. |
Odśwież test weryfikacji tokena
Tokeny odświeżania są testowane, aby mieć pewność, że punkt końcowy wymiany tokenów prawidłowo wymienia je na nowe tokeny dostępu.
Elementy testowe | Wyjaśnienie |
---|---|
Token odświeżania z nieprawidłowym tokenem – sprawdzam odpowiedź partnera. | W odpowiedzi na nieprawidłowe żądanie tokena odświeżania Twój serwer powinien zwracać błąd HTTP 400 Bad Request o treści {"error": "invalid_grant"} .
Jeśli odpowiedź nie pasuje do „kodu błędu lub komunikatu”, ten przypadek testowy zakończy się niepowodzeniem. Więcej informacji znajdziesz w artykule o
wymianie tokenów odświeżania tokenów dostępu. |
Sprawdź, czy token dostępu został zaktualizowany po jego odświeżeniu. | W odpowiedzi na żądania tokenów odświeżania powinny być zwracane nowe tokeny dostępu. Jeśli serwer zapewnia ten sam token dostępu, przypadek testowy zakończy się niepowodzeniem. |
Sprawdź, czy nieaktualny token dostępu jest nadal prawidłowy. | Zostanie wyświetlony czas wygaśnięcia tokena dostępu. |
Sprawdź, czy token odświeżania nie został poddany rotacji podczas odświeżania. | Sprawdzamy, czy tokeny odświeżania są zmieniane po otrzymaniu żądania tokena 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. Pozwoli to uniknąć problemów związanych z wyścigiem, które mogłyby spowodować przerwanie łączenia 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ć problem |
---|---|
Interfejs HomeGraph API nie był wcześniej używany w projekcie <_id_> lub jest wyłączony | Włącz HomeGraph API. |
Nie znaleziono żądanego elementu | Sprawdź, czy agentUserId jest prawidłowy i połączony z Twoją usługą. |
Sprawdź, czy masz uprawnienie Podczas pobierania danych modułu wystąpił błąd: getModuleData: odpowiedź błędu HTTP dla https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Przesyłanie wyników testu
Przed przesłaniem formularza certyfikacyjnego Twoje wyniki testu Test Suite muszą zostać zaliczone. Jeśli masz cechy wymagające testów ręcznych, nadal uruchamiaj narzędzie Test Suite i dołącz wyniki nawet wtedy, gdy nie wystarczą testu 100%.
Aby przesłać wyniki testu i potwierdzić działanie inteligentnego domu, wykonaj te czynności:
- Gdy otrzymasz wyniki testu i chcesz uzyskać certyfikat, kliknij Prześlij w narzędziu Test Suite.
- Aby pobrać wyniki testu, kliknij przycisk POBIERZ WYNIKI TESTU.
- Aby przesłać wyniki testu do Google, kliknij OTWÓRZ FORMULARZ ZGŁOSZANIA PRZESŁANIA.
Wypełnij wszystkie wymagane pola i kliknij Prześlij.