Z chmury do chmury Pakiet SDK Local Home
Google Home Test Suite to aplikacja internetowa, dzięki której możesz: samodzielnie przetestujesz działanie inteligentnego domu. Test Suite automatycznie generuje i uruchamia przypadki testowe na podstawie urządzeń i cech powiązane 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 Test Suite obejmują, ale nie są, ograniczona do:
Sprawdza, czy Stan raportu oraz Wdrożono synchronizację żądań dla Twojego urządzeń i cech.
Sprawdza, czy intencja QUERY jest zaimplementowany na Twoim urządzeniu, a jego wyniki odpowiadają wynikom stanu raportu.
Narzędzie Test Suite możesz uruchomić, klikając przycisk poniżej:
Samodzielne testowanie działania
Z tej sekcji dowiesz się, jak uruchamiać Test Suite na urządzeniu i w inteligentnym projekcie Akcji. Aplikacja Test Suite wymaga zalogowania się, aby mogła sprawdzić urządzenia w Twoim Google Home Graph i wysyłać polecenia bezpośrednio do Google Assistant.
Aby samodzielnie przetestować działanie, 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 Działanie inteligentnego domu.
- Kliknij Dalej.
Skonfiguruj Ustawienia testu:
- Jeśli certyfikujesz działanie w ramach inteligentnego domu, pozostaw domyślną wartość Okres oczekiwania na raport stanu/synchronizację zapytań. Jednak dla testowania, możesz zmienić wartość czasu oczekiwania, jeśli agent potrzebuje więcej czasu stan raportu na Home Graph.
W przypadku certyfikowania akcji inteligentnego domu upewnij się, że synchronizacja żądania testowego została przeprowadzona. jest włączona. Podczas testów pojawi się prośba o dodanie, zaktualizować lub usunąć urządzenie i sprawdzić, czy lista urządzeń uległa zmianie Home Graph. Działania zmiany są podejmowane w ramach integracji, w której jesteś i testowania. Testowana integracja musi zawsze mieć co najmniej 1 urządzenie powiązane z użytkownikiem agenta.
Jeśli używasz cechy Scene, wybierz Testowa cecha sceny.
Jeśli korzystasz z pakietu testowego dla lokalnych urządzeń domowych, wybierz Obsługuje pakiet SDK Local Home SDK.
- Wybierz Realizacja lokalna lub Bezproblemowa konfiguracja.
- Kliknij Obsługuje zapytanie lokalne, jeśli urządzenie może obsługiwać intencję ZAPYTANIE lokalnie.
Przeprowadź test i wyświetl wyniki:
- Kliknij Dalej, aby rozpocząć testy. W interfejsie widoczne są urządzenia i cechy, które są testowane.
Wyświetl Wyniki i Strona przesyłania:
- Po zakończeniu testów kliknij Dalej, aby wyświetlić wyniki.
Wyniki testu obejmują liczbę testów zaliczonych i niezaliczonych oraz końcową ocenę wskazującą odsetek zaliczonych testów.
Test weryfikacji połączenia kont
Łączenie kont powoduje odgrywają ważną rolę w ekosystemie inteligentnego domu Google. Łączenie kont test weryfikacji w: Test Suite sprawdza, czy w usłudze OAuth potencjalnych problemów.
Test łączenia kont obejmuje testy sprawdzające tokeny dostępu. i tokeny odświeżania:
Testowanie poprawności tokena dostępu
Tokeny dostępu zwracane z punktu końcowego wymiany tokenów są testowane w celu sprawdzenia, 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
Znaleziono format JWT. 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 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 zapewnienia prawidłowego punktu końcowego wymiany tokenów wymieni je na nowe tokeny dostępu.
Elementy testowe | Wyjaśnienie |
---|---|
Odświeżanie tokena z nieprawidłowym tokenem odświeżania, sprawdzanie odpowiedzi partnera. | Serwer powinien zwrócić 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”, w tym przypadku testowego
nie powiedzie się. Więcej informacji znajdziesz w artykule
wymiana tokenów odświeżania na tokeny dostępu. |
Sprawdź, czy po odświeżeniu tokena token dostępu został zaktualizowany. | Nowe tokeny dostępu powinny być zwracane w odpowiedzi na prośby o tokeny odświeżania. Jeśli serwer udostępnia ten sam token dostępu, przypadek testowy niepowodzenie. |
Sprawdź, czy token dostępu, który nie utracił ważności, jest nadal ważny. | Zostanie wyświetlony czas ważności tokena dostępu. |
Sprawdź, czy podczas odświeżania został zmieniony token odświeżania. | 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 ulegnie zmianie, serwer powinien unieważnić stary token odświeżania dopiero po użyciu nowego, aby zapobiec konfliktom, które mogą spowodować przerwanie łączenia konta użytkownika. Test się nie powiedzie, jeśli: unieważnić stary token odświeżania przed użyciem nowego. |
Komunikaty o błędach
W poniższej tabeli znajdziesz niektóre typowe komunikaty o błędach, które możesz napotkać, a zaproponowany sposób ich rozwiązania.
Komunikat o błędzie | Jak rozwiązać |
---|---|
Interfejs HomeGraph API nie był używany w projekcie <_id_> przed lub jest wyłączony | Sprawdź, czy masz włączony interfejs HomeGraph API. |
Nie znaleziono żądanej jednostki | Sprawdź, czy karta agentUserId jest ważna i jest połączona z
posprzedażna. |
Upewnij się, że masz uprawnienie Podczas pobierania danych modułu wystąpił błąd: błąd getModuleData: odpowiedź dotycząca błędu HTTP dla https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Prześlij wyniki testu
Twoje wyniki w języku: Test Suite muszą zaliczyć 100% testów przed przesyłając formularz certyfikacji. Jeśli masz cechy, które wymagają ręcznie, nadal używaj narzędzia Test Suite. dołącza wynik, nawet jeśli nie jest on wyższy niż 100%.
Aby przesłać wyniki testu i certyfikować działanie inteligentnego domu, wykonaj te czynności:
- Po otrzymaniu wyników testu i możliwości certyfikacji w domu, kliknij Submit (Prześlij) w narzędziu Test Suite.
- Aby pobrać wyniki testu, kliknij przycisk POBIERZ WYNIKI TESTU.
- Kliknij OTWÓRZ FORMULARZ ZGŁOSZENIOWY, aby przesłać wyniki testu do Google.
Wypełnij wszystkie wymagane pola i kliknij Prześlij.