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ć działanie inteligentnego domu. Test Suite automatycznie generuje i uruchamia zgłoszenia 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, aby przesłać je do Google.

Testy wykonywane przez Test Suite obejmują między innymi:

  • Sprawdza, czy funkcje Stan raportowania i Prośba o synchronizację zostały wdrożone na Twoich urządzeniach i w Twoich cechach.

  • Sprawdzenie, czy intencja QUERY została wdrożona na Twoim urządzeniu i jego wyniki są zgodne z wynikami stanu raportu.

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

Uruchomienie Test Suite

Przetestuj swoje działanie

Z tej sekcji dowiesz się, jak uruchomić Test Suite na urządzeniu i w projekcie Smart Home. Test Suite wymaga zalogowania się, by sprawdzić urządzenia w obszarze Google Home Graph i wysłać polecenia bezpośrednio do Google Assistant.

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

  1. Otwórz Test Suite w przeglądarce.
  2. Zaloguj się w Google, klikając przycisk w prawym górnym rogu.

  3. Skonfiguruj Szczegóły projektu:

    1. W polu Identyfikator projektu wpisz identyfikator projektu inteligentnego działania na stronie głównej.
    2. Kliknij Dalej.
  4. Skonfiguruj ustawienia testu:

    1. Jeśli certyfikujesz działanie inteligentnego domu, pozostaw domyślną wartość Report State/Request Sync Timeout (Czas oczekiwania raportu/żądania synchronizacji) bez zmian. Na potrzeby testów możesz jednak zmienić wartość limitu czasu, jeśli agent potrzebuje więcej czasu, aby zgłosić stan do wykresu z wykresem głównym.
    2. Jeśli certyfikujesz działanie inteligentnego działania na stronie głównej, włącz opcję Test żądania synchronizacji – 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. Działania dotyczące wprowadzenia zmian wynikają z testowanej integracji. W trakcie testowania Twoja integracja z agentem musi mieć co najmniej 1 urządzenie.

    3. Jeśli korzystasz z funkcji Scene, wybierz Testuj scenę.

  5. Wykonaj uruchomienie testu i wyświetl wyniki:

    1. Aby rozpocząć testy, kliknij Dalej. Interfejs pokazuje urządzenia i cechy, które są testowane.
  6. Wyświetlanie strony Wyniki i przesyłanie:

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

Wyniki testu zawierają liczbę zaliczonych i niezaliczonych testów oraz końcowy wynik wskazujący odsetek testów, które zostały zaliczone.

Test weryfikacji połączenia konta

Łączenie kont odgrywa ważną rolę w ekosystemie Google Home. Test weryfikacji połączenia konta w aplikacji Test Suite sprawdza usługę OAuth pod kątem potencjalnych problemów.

Test weryfikacji połączenia kont obejmuje testy tokenów dostępu i odświeżania tokenów:

Test weryfikacji tokena dostępu

Tokeny dostępu zwrócone z punktu końcowego wymiany tokenów są testowane pod kątem prawidłowego formatu i zwracanego z prawidłowym tokenem odświeżania.

Elementy do testowania Objaśnienie
Sprawdź, czy token dostępu jest w formacie JWT Łączenie kont Google nie zaleca stosowania tokenów dostępu do formatu JWT. Jeśli znajdziemy format tokena JWT, pojawi się takie 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 możliwego do wygaśnięcia ma token odświeżania. Jeśli token dostępu ma ważność, należy podać token odświeżania. Jeśli test nie zostanie znaleziony, test zakończy się niepowodzeniem.

Odśwież test weryfikacji tokena

Tokeny odświeżania są testowane, by upewnić się, że 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. Serwer powinien zwrócić błąd HTTP 400 Bad Request z błędem {"error": "invalid_grant"} w nieprawidłowym żądaniu odświeżania. Jeśli odpowiedź nie będzie zgodna z „kodem błędu lub komunikatem”, ta próba testowa zakończy się niepowodzeniem. Więcej informacji znajdziesz w artykule Wymienianie tokenów odświeżania w tokenach 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 odświeżania. Jeśli serwer dostarczy ten sam token dostępu, przypadek testowe się nie powiedzie.
Sprawdź, czy token dostępu jest nadal ważny. Zostanie wyświetlony czas wygaśnięcia tokena dostępu.
Sprawdź, czy token odświeżania został obrócony podczas odświeżania. Sprawdzamy, czy tokeny odświeżania zmieniają się po żądaniu tokena odświeżania. W przypadku zmiany tokena odświeżania serwer powinien unieważnić stary token odświeżania tylko po użyciu nowego tokena odświeżania, aby uniknąć warunków wyścigu, które może zakłócić łączenie kont użytkownika. Test się nie powiedzie, jeśli unieważnisz stary token odświeżania, zanim użyjesz nowego.

Komunikaty o błędach

W tabeli poniżej znajdziesz typowe komunikaty o błędach i sugerowane sposoby ich rozwiązania.

Komunikat o błędzie Rozwiązanie
Interfejs HomeGraph API nie był wcześniej używany w projekcie <_id_> lub jest wyłączony Upewnij się, że masz włączony HomeGraph API.
Nie znaleziono żądanego elementu Sprawdź, czy usługa agentUserId jest prawidłowa i jest połączona z Twoją usługą.
Sprawdź, czy masz uprawnienia resourcemanager.projects.get w projekcie ${your project id} i wszystkie uprawnienia na ekranie zgody.
  1. Wykonaj instrukcje opisane w artykule Rozwiązywanie problemów z uprawnieniami, aby mieć pewność, że Twoje konto ma uprawnienia resourcemanager.projects.get dla projektu.
  2. Otwórz stronę Aplikacje, które mają dostęp do Twojego konta, aby sprawdzić te uprawnienia dotyczące „Test Suite dla inteligentnego domu”:
    • Podstawowe informacje o koncie
      1. Wyświetlanie podstawowego adresu e-mail Twojego konta Google
      2. Wyświetlanie prywatnych informacji o Tobie, w tym tych udostępnionych przez Ciebie publicznie
    • Dodatkowy dostęp
      1. Assistant: szeroki dostęp do konta Google
      2. Sprawdzanie inteligentnych urządzeń domowych w Twoim Home Graph i sterowanie nimi
    Jeśli brakuje nikogo, najpierw usuń dostęp i przyznaj wszystkie uprawnienia na ekranie zgody po ponownym zalogowaniu.

Prześlij wyniki testu

Twoje wyniki Test Suite muszą przejść 100% testów, zanim prześlesz formularz certyfikacji. Jeśli masz cechy, które wymagają ręcznego sprawdzenia, należy uruchomić narzędzie Test Suite i dołączyć wynik, nawet jeśli nie został spełniony w 100%.

Aby przesłać wyniki testów i zatwierdzić inteligentne działanie w domu, wykonaj te czynności:

  1. Gdy otrzymasz wyniki testu i będziesz mieć możliwość uzyskania certyfikatu na temat inteligentnego domu, kliknij Prześlij w narzędziu Test Suite.
  2. Kliknij przycisk POBIERZ WYNIKI TESTOWE, aby pobrać wyniki testu.
  3. Kliknij PRZEJDŹ DO FORMULARZU PRZESYŁANIA, aby przesłać do Google wyniki testów.
  4. Wypełnij wszystkie wymagane pola i kliknij Prześlij.