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 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:

Uruchom aplikację Test Suite

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:

  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 Działanie inteligentnego domu.
    2. Kliknij Dalej.
  4. Skonfiguruj Ustawienia testu:

    1. 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.
    2. 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.

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

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

      1. Wybierz Realizacja lokalna lub Bezproblemowa konfiguracja.
      2. Kliknij Obsługuje zapytanie lokalne, jeśli urządzenie może obsługiwać intencję ZAPYTANIE lokalnie.
  5. Przeprowadź test i wyświetl wyniki:

    1. Kliknij Dalej, aby rozpocząć testy. W interfejsie widoczne są urządzenia i cechy, które są testowane.
  6. Wyświetl Wyniki i Strona przesyłania:

    1. 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 resourcemanager.projects.get w projekcie ${your project id} i że przyznałeś/aś wszystkie uprawnienia na ekranie zgody.

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

  1. Postępuj zgodnie z instrukcjami podanymi w artykule Rozwiązywanie problemów. uprawnienia, dzięki którym Twoje konto będzie mieć Uprawnienia: resourcemanager.projects.get w projekcie.
  2. Otwórz stronę Aplikacje, które mają dostęp do Twojego konta, aby sprawdzić te uprawnienia „Pakiet testowy dla inteligentnego domu”:
    • Podstawowe informacje o koncie
      1. Wyświetlanie podstawowego adresu e-mail Twojego konta Google
      2. Wyświetlanie Twoich danych osobowych, w tym wszelkich udostępnione publicznie
    • Dodatkowy dostęp
      1. Używaj Assistant: szeroki dostęp do Twoje konto Google
      2. Sprawdzanie inteligentnych urządzeń domowych w domu i sterowanie nimi Wykres
    Jeśli pojawi się błąd dotyczący uprawnień, najpierw odbierz dostęp i przyznaj wszystkie uprawnienia na ekranie zgody po ponownym zalogowaniu.

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:

  1. Po otrzymaniu wyników testu i możliwości certyfikacji w domu, kliknij Submit (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.