Plac zabaw Google Home

Pakiet SDK na urządzenia

Google Home Playground to aplikacja internetowa, która symuluje projekt inteligentnego domu z konfigurowalnymi typami urządzeń. Możesz tworzyć urządzenia wirtualne, modyfikować ich atrybuty i stany, wyświetlać je w Google Home Graph oraz importować i eksportować konfiguracje urządzeń.

Dokończ łączenie konta

Aby używać narzędzia Google Home Playground, zalecamy najpierw połączenie go z kontem. Otwórz 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 akcję o nazwie Google Home Playground.
  4. Wybierz działanie, a GHA przekieruje Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz konto, by się zalogować.
  5. Kliknij przycisk Autoryzuj, by autoryzować połączenie kont.
Ilustracja przedstawiająca proces łączenia konta aplikacji Google Home podczas łączenia z Google Home Playground.

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

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

Zaloguj się

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

Uruchom Playground

Kliknij Zaloguj się przez Google. Pamiętaj, aby zalogować się za pomocą tego samego konta, którego użyto do łączenia kont GHA.

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

Gdy się zalogujesz, Google Home Playground wyświetli urządzenia wirtualne zapisane na koncie Home Graph.

Ten rysunek przedstawia listę urządzeń, informacje o urządzeniach i obszar logów w domyślnym widoku Google Home Playground.

Interfejs internetowy składa się z 3 paneli:

  • Lista urządzeń zawiera wszystkie Twoje urządzenia wirtualne. Możesz wybrać konkretne urządzenie wirtualne, aby wyświetlić jego informacje i utworzyć urządzenia wirtualne w tym panelu.
  • Informacje o urządzeniu: pokazuje informacje o wybranym urządzeniu wirtualnym. Możesz też edytować te informacje i usunąć w panelu wybrane urządzenie wirtualne.
  • Obszar logów zawiera logi interakcji między Google Home Playground a Home Graph. Możesz rozwinąć logi, aby zbadać ładunki żądań i odpowiedzi w celu rozwiązywania problemów.

Urządzenie wirtualne

Wyświetlanie informacji 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ć. W panelu Informacje o urządzeniu wyświetlą się informacje podzielone na 5 kart:

  • Informacje podstawowe: główne właściwości urządzenia, w tym typ, identyfikator i nazwa.
  • Cechy: obsługiwane cechy urządzenia.
  • Atrybuty: atrybuty urządzenia dostosowane do konkretnych cech.
  • Stany:wszystkie stany urządzeń.
  • SUV: dodatkowa weryfikacja użytkownika urządzenia.

Edytuj informacje o urządzeniu wirtualnym

Oprócz wyświetlania informacji o urządzeniu wirtualnym możesz też bezpośrednio edytować informacje o nim przechowywane w Home Graph, korzystając z panelu Informacje o urządzeniu.

Modyfikuj obsługiwane cechy

  1. Wybierz kartę Traits i kliknij przycisk Edytuj.
  2. W wyskakującym okienku zobaczysz aktualnie obsługiwane cechy urządzenia i dostępne cechy, które możesz dodać. Użyj przycisków strzałki (arrow_forward/arrow_back), aby dodać lub usunąć obsługiwane cechy urządzenia.
  3. Po zaktualizowaniu obsługiwanych cech kliknij Zapisz, a zaktualizowane cechy zostaną zastosowane do: Home Graph.
  4. Te aktualizacje cech możesz zobaczyć w obszarze logu.
Ten rysunek pokazuje narzędzie UX do dodawania lub 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 atrybutu Home Graph.
  3. Zaktualizowane atrybuty możesz zobaczyć w obszarze logu.

Modyfikowanie stanów urządzeń

  1. Kliknij kartę Stany i bezpośrednio zmień stan. Zmiany stanu zostaną zastosowane do: Home Graph.
  2. Te zmiany stanu możesz zobaczyć w obszarze logu.

Dodawanie dodatkowej weryfikacji użytkownika na urządzeniu wirtualnym

Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować jego typ wyzwania oraz odpowiadające mu zachowanie na każdym urządzeniu. Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować jego typ wyzwania oraz odpowiadające mu zachowanie na każdym urządzeniu.

Konfigurowanie funkcji SUV 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:
Rysunek przedstawia narzędzie UX, które włącza dodatkowe cechy weryfikacji użytkowników na wybranym urządzeniu w Google Home Playground.

Identyfikowanie urządzeń, które umożliwiają korzystanie z SUV-a

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

Ten rysunek pokazuje urządzenia, na których zaleca się włączenie dodatkowej weryfikacji użytkowników.

Te cechy wymagają 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. Gdy wykonasz wszystkie te czynności, nowe urządzenie zostanie dodane do domu Home Graph.
Ilustracja pokazująca narzędzie UX, które służy do dodawania nowego typu urządzeń 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. Następnie w panelu Informacje o urządzeniu wybierz kartę Informacje podstawowe i u dołu kliknij Ikona koszaUsuń urządzenie.
  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 pokazująca narzędzie UX, które służy do usuwania typu urządzeń wirtualnych w Google Home Playground.

Edytor odpowiedzi synchronizacji

Odpowiedź synchronizacji możesz sprawdzić lub zaktualizować w narzędziu Google Home Playground. Kliknij Sync Response Editor (Edytor odpowiedzi synchronizacji), aby otworzyć umieszczone IDE.

Ten rysunek pokazuje przycisk otwierający edytor odpowiedzi synchronizacji.

Edytuj lub skopiuj i wklej swoją odpowiedź synchronizacji, a następnie kliknij Zapisz, aby zastosować zmiany i przekonać się, jak ta odpowiedź działa w ekosystemie Google Home.

Ten rysunek pokazuje okno edytowania odpowiedzi synchronizacji.

Importowanie i eksportowanie urządzeń wirtualnych

Na potrzeby rozwiązywania problemów lub ich odtwarzania możesz wyeksportować do pliku stan urządzeń wirtualnych i udostępnić ten plik innym osobom, aby je zaimportować i zreplikować.

Ilustracja przedstawiająca narzędzie UX służące 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. Po wpisaniu nazwy pliku przeglądarka pobierze plik z wyeksportowanymi urządzeniami wirtualnymi.

Importowanie urządzeń wirtualnych 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 z pliku urządzenia wirtualne o określonych stanach i zaktualizuje informacje o importowanych urządzeniach oraz ich stan w sekcji Home Graph.

Sprawdzanie dzienników interakcji

Gdy korzystasz z urządzeń wirtualnych, Google Home Playground automatycznie stosuje zmianę na urządzeniu Home Graph. Interakcje z Home Graph są rejestrowane w panelu Obszar logu, w którym możesz rozwinąć każdy wpis, aby sprawdzić ładunki żądań i odpowiedzi interfejsu Home Graph API.

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.
response object Treść odpowiedzi wywołania interfejsu API Home Graph. Format poszczególnych metod znajdziesz w dokumentacji referencyjnej dokumentacji.

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

Ikona znaku zapytania pomoc w prawym górnym rogu spowoduje wyświetlenie bieżącego typu urządzenia i listy cech obsługiwanych przez Google Home Playground.

Ilustracja pokazująca narzędzie UX, które służy do dodawania nowego typu urządzeń w Google Home Playground.

Zgłaszanie problemów

Chętnie poznamy Twoją opinię. Problemy można zgłaszać, korzystając z ikony wykrzyknika i opinii w prawym górnym rogu.

Ten rysunek pokazuje ikony służące do przesyłania opinii i zgłaszania problemów w Google Home Playground.