Plac zabaw Google Home

Z chmury do chmury    Pakiet SDK Local Home    Pakiet SDK urządzenia

Google Home Playground to aplikacja internetowa symulująca inteligentny projekt domowy z konfigurowalnymi typami urządzeń i cechami. Możesz tworzyć urządzenia wirtualne, modyfikować ich atrybuty i stany, wyświetlać je w Google Home Graph oraz importować i eksportować ich konfiguracje.

Dokończ łączenie kont

Zalecamy, aby najpierw połączyć narzędzie z kontem, aby używać narzędzia Google Home Playground. Otwórz aplikację Google Home app (GHA) na telefonie i wykonaj proces łączenia kont:

  1. Kliknij ikonę plusa (+) w lewym górnym rogu.
  2. Wybierz Skonfiguruj urządzenie > Obsługiwane przez Google.
  3. Wyszukaj działanie o nazwie Google Home Playground.
  4. Wybierz działanie, a GHA przekieruje Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz konto, na które chcesz się zalogować.
  5. Aby autoryzować połączenie kont, kliknij przycisk Autoryzuj.
Ilustracja pokazująca proces łączenia konta w aplikacji Google Home w celu połączenia Google Home Playground.

Gdy zakończysz łączenie kont, na urządzeniu GHA pojawi się zestaw domyślnych urządzeń wirtualnych, z których możesz korzystać.

Ten rysunek przedstawia domyślną listę urządzeń, która wypełnia się, gdy użytkownik połączy Playground Google Home ze swoim kontem.

Zaloguj się

Uruchom Google Home Playground, klikając przycisk poniżej:

Uruchom Playground

Kliknij Zaloguj się przez Google. Pamiętaj, aby zalogować się na konto, którego używasz w aplikacji GHA do dokończenia łączenia kont.

Ilustracja przedstawia początkowy stan Google Home Playground i wyróżnia przycisk logowania w prawym górnym rogu.

Gdy się zalogujesz, na stronie Google Home Playground pojawią się urządzenia wirtualne zapisane w aplikacji Home Graph.

Ten rysunek przedstawia listę urządzeń, informacje o urządzeniu i obszar dziennika w domyślnym widoku aplikacji Google Home Playground.

Interfejs internetowy składa się z 3 paneli:

  • Lista urządzeń zawiera wszystkie Twoje urządzenia wirtualne. W panelu możesz wybrać konkretne urządzenie wirtualne, aby wyświetlić o nim informacje i utworzyć takie urządzenia.
  • Informacje o urządzeniu zawierają informacje o wybranym urządzeniu wirtualnym. Możesz też edytować te informacje i usunąć wybrane urządzenie wirtualne w panelu.
  • Obszar logu: wyświetla dzienniki interakcji między Google Home Playground a Home Graph. Możesz rozwinąć logi, aby zbadać ładunki żądań i odpowiedzi pod kątem rozwiązywania problemów.

Urządzenie wirtualne

Wyświetl informacje o urządzeniu wirtualnym

W panelu Lista urządzeń wybierz urządzenie wirtualne, które chcesz wyświetlić. W panelu Lista urządzeń wybierz urządzenie wirtualne, które chcesz wyświetlić. Informacje o urządzeniu są wyświetlane w panelu Informacje o urządzeniu, podzielone na pięć kart:

  • Informacje podstawowe: najważniejsze właściwości urządzenia, w tym jego typ, identyfikator i nazwa.
  • Cechy: obsługiwane cechy urządzenia.
  • Atrybuty: atrybuty urządzenia związane z jego cechami.
  • Stany: wszystkie stany urządzenia.
  • SUV: konfiguracja dodatkowej weryfikacji użytkownika urządzenia.

Edytuj informacje o urządzeniu wirtualnym

Panel Informacje o urządzeniu pozwala nie tylko wyświetlać informacje o urządzeniu wirtualnym, ale też bezpośrednio edytować ich dane przechowywane w usłudze Home Graph.

Zmodyfikuj obsługiwane cechy

  1. Wybierz kartę Cetras i kliknij przycisk Edytuj.
  2. W wyskakującym okienku zobaczysz cechy urządzenia, które są obecnie obsługiwane, oraz te, które możesz dodać. Za pomocą przycisków strzałki (arrow_forward/arrow_back) dodaj lub usuń obsługiwane cechy urządzenia.
  3. Po zaktualizowaniu obsługiwanych cech kliknij Zapisz. Zaktualizowane cechy zostaną zastosowane do modelu Home Graph.
  4. Aktualizacje cech możesz wyświetlić w obszarze dziennika.
Ilustracja przedstawia narzędzie UX służące do dodawania i usuwania obsługiwanych cech na wybranym urządzeniu w Google Home Playground.

Modyfikowanie atrybutów urządzenia

  1. Wybierz kartę Atrybuty i edytuj atrybut cech obsługiwanych przez urządzenie.
  2. Po zakończeniu edytowania naciśnij Enter, a zmiany atrybutów zostaną zastosowane do Home Graph.
  3. Zaktualizowane atrybuty możesz wyświetlić w Obszarze logów.

Modyfikowanie stanów urządzeń

  1. Wybierz kartę Stany i bezpośrednio edytuj stan. Zmiany stanu zostaną zastosowane do obszaru Home Graph.
  2. Te zmiany stanu możesz wyświetlić w obszarze logów.

Dodawanie dodatkowej weryfikacji użytkownika na urządzeniu wirtualnym

Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować jego typ testu zabezpieczającego oraz odpowiadające mu działanie na każdym urządzeniu. Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować jego typ testu zabezpieczającego oraz odpowiadające mu działanie na każdym urządzeniu.

Skonfiguruj SUV-a na urządzeniu

  1. W panelu Lista urządzeń wybierz urządzenie wirtualne, które chcesz skonfigurować.
  2. W panelu Informacje o urządzeniu wybierz kartę SUV i skonfiguruj te ustawienia:
    • Włączone: określa, czy funkcja SUV jest włączona czy wyłączona (brak testu) na urządzeniu.
    • Rodzaj wyzwania: czy SUV wymaga jednoznacznego potwierdzenia (ackNeeded) czy osobisty numer identyfikacyjny (pinNeeded).
    • PIN:prawidłowy kod PIN.
    • Obsługa nieprawidłowego kodu PIN: gdy kod PIN jest błędny – czy ponownie poprosić użytkownika o odpowiedź, a jeśli nie, czy otrzymać komunikat o błędzie.
Ilustracja przedstawia narzędzie UX umożliwiające włączenie dodatkowych cech weryfikacji użytkowników na wybranym urządzeniu w Google Home Playground.

Identyfikuj urządzenia, na których można włączyć SUV-y

W panelu Lista urządzeń obok każdego urządzenia obsługującego SUV-a wyświetla się ikona klucza klucz.

Na tym rysunku znajdują się urządzenia, na których zalecamy włączenie dodatkowej weryfikacji użytkownika.

Ta lista cech wymaga SUV-a:

Utwórz nowe urządzenie wirtualne

  1. W panelu Lista urządzeń kliknij Dodaj urządzenie.
  2. W wyskakującym okienku wybierz typ urządzenia i wpisz jego nazwę. Możesz też wybrać wstępnie zdefiniowany zestaw urządzeń do dodania.
  3. Po wykonaniu wszystkich czynności nowe urządzenie zostanie dodane do Home Graph.
Ilustracja pokazująca narzędzie UX do dodawania urządzeń nowego typu w Google Home Playground.

Usuwanie urządzenia wirtualnego

  1. W panelu Lista urządzeń wybierz urządzenie, które chcesz usunąć. Następnie w panelu Informacje o urządzeniu wybierz kartę Informacje podstawowe, a następnie w panelu Informacje o urządzeniu wybierz kartę Informacje podstawowe i kliknij Ikona koszaUsuń urządzenie u dołu.
  2. Potwierdź usunięcie urządzenia w wyskakującym okienku.
  3. Gdy potwierdzisz usunięcie urządzenia, zostanie ono usunięte z Home Graph.
Ilustracja przedstawia narzędzie UX do usunięcia typu urządzenia wirtualnego w Google Home Playground.

Edytor odpowiedzi na synchronizację

Możesz zweryfikować lub zaktualizować odpowiedź synchronizacji w Google Home Playground. Kliknij Sync Response Editor (Edytor odpowiedzi synchronizacji), aby otworzyć osadzone IDE.

Ten rysunek przedstawia przycisk otwierający edytor odpowiedzi synchronizacji.

Edytuj lub skopiuj i wklej odpowiedź synchronizacji, a następnie kliknij Zapisz, aby zastosować zmiany i zobaczyć, jak działa ona w ekosystemie Google Home.

Ten rysunek przedstawia okno edytowania odpowiedzi synchronizacji.

Importowanie i eksportowanie urządzeń wirtualnych

Aby rozwiązać lub odtworzyć problemy, możesz wyeksportować urządzenia wirtualne ze stanami do pliku, a potem udostępnić ten plik innym osobom, aby mogły je zaimportować i powielić.

Ilustracja przedstawia narzędzie UX do importowania i eksportowania urządzeń wirtualnych w Google Home Playground.

Eksportowanie urządzeń wirtualnych do pliku

  1. Kliknij , aby wyeksportować urządzenia wirtualne do pliku.
  2. Wpisz nazwę pliku, który chcesz wyeksportować, i kliknij OK.
  3. Gdy podasz nazwę pliku, przeglądarka pobierze plik z wyeksportowanymi urządzeniami wirtualnymi.

Importuj urządzenia wirtualne z pliku

  1. Kliknij , aby zaimportować urządzenia wirtualne z pliku.
  2. Wybierz plik, który chcesz zaimportować, i kliknij OK.
  3. Gdy potwierdzisz plik do zaimportowania, Google Home Playground zaimportuje urządzenia wirtualne ze stanami z pliku oraz zaktualizuje informacje i stany zaimportowanych urządzeń w Home Graph.

Sprawdź dzienniki interakcji

Gdy wchodzisz w interakcję z urządzeniami wirtualnymi, Google Home Playground automatycznie wprowadza zmianę w Home Graph. Interakcje z funkcją Home Graph są rejestrowane w panelu Obszar logu, gdzie możesz rozwinąć każdy wpis, aby przeanalizować ładunki żądań i odpowiedzi do interfejsu API Home Graph.

Każdy wpis logu jest tablicą JSON zawierającą elementy o następującej strukturze:

{
  "uri": string,
  "request": object,
  "response": object
}
Pola Typ Opis
uri string Adres URL wywołania interfejsu API Home Graph.
request object Treść żądania wywołania interfejsu API Home Graph. Format poszczególnych metod znajdziesz w dokumentacji referencyjnej dokumentacji referencyjnej.
response object Treść odpowiedzi wywołania interfejsu API Home Graph. Format poszczególnych metod znajdziesz w dokumentacji referencyjnej dokumentacji referencyjnej.

Wyświetl obsługiwane typy i cechy urządzeń

Ikona znaku zapytania pomoc w prawym górnym rogu wyświetli aktualny typ urządzenia i listę cech obsługiwane przez Google Home Playground.

Ilustracja pokazująca narzędzie UX do dodawania urządzeń nowego typu w Google Home Playground.

Zgłaszanie problemów

Chętnie poznamy Twoją opinię. Wystąpiły problemy podczas zgłaszania problemów, korzystając z ikony wykrzyknika opinii w prawym górnym rogu.

Ilustracja przedstawia ikony umożliwiające przesyłanie opinii i zgłaszanie problemów w Google Home Playground.