Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

Google Home Test Suite,

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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 związanych z Twoim kontem. Po ukończeniu testów możesz wyświetlić ich wyniki lub wypełnić formularz przesyłania, aby przesłać je do 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ę, aby urządzenie mogło sprawdzać dane Google Home Graph i wysyłać polecenia bezpośrednio do 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.
  1. 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.
  2. 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
      1. Wyświetlanie podstawowego adresu e-mail Twojego konta Google
      2. Wyświetlanie Twoich danych osobowych, w tym udostępnionych przez Ciebie publicznie
    • Dodatkowy dostęp
      1. Użyj konta Assistant: szeroki dostęp do konta Google
      2. Sprawdzanie inteligentnych urządzeń domowych w Twoim Home Graph i sterowanie nimi
    Jeśli kogoś nie ma, usuń dostęp i najpierw przyznaj wszystkie uprawnienia na ekranie zgody, gdy zalogujesz się ponownie.

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.