Plac zabaw Google Home

Pakiet SDK urządzenia

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

Dokończ łączenie konta

Zalecamy, aby przed użyciem narzędzia Google Home Playground najpierw połączyć je z kontem. Otwórz na telefonie aplikację Google Home app (GHA) 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, na które chcesz się zalogować.
  5. Kliknij przycisk Autoryzuj, by autoryzować połączenie kont.
Ilustracja przedstawia proces łączenia konta aplikacji Google Home w celu łączenia Google Home Playground.

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

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

Zaloguj się

Kliknij przycisk poniżej, aby uruchomić usługę Google Home Playground:

Uruchom Playground

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

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

Po zalogowaniu się Google Home Playground wyświetli urządzenia wirtualne zapisane w Home Graph.

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

Interfejs internetowy składa się z 3 paneli:

  • Lista urządzeń zawiera wszystkie Twoje urządzenia wirtualne. W tym panelu możesz wybrać konkretne urządzenie wirtualne, aby wyświetlić jego informacje i utworzyć urządzenia wirtualne.
  • Informacje o urządzeniu zawiera informacje o wybranym urządzeniu wirtualnym. Możesz też edytować te informacje i usunąć w panelu wybrane urządzenie wirtualne.
  • Obszar logu wyświetla logi interakcji między Google Home Playground a Home Graph. Możesz rozwinąć logi, aby sprawdzić ładunki żądań i odpowiedzi na potrzeby 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 w panelu Informacje o urządzeniu pojawią się na 5 kartach:

  • Informacje podstawowe: najważniejsze właściwości urządzenia, w tym typ, identyfikator i nazwa.
  • Cechy: obsługiwane cechy urządzenia.
  • Atrybuty: cechy urządzenia.
  • Stany:wszystkie stany urządzeń.
  • SUV: dodatkowa weryfikacja użytkownika urządzenia.

Edytuj informacje o urządzeniu wirtualnym

Poza wyświetlaniem informacji o urządzeniu wirtualnym możesz też edytować informacje o nim zapisane w Home Graph za pomocą panelu Informacje o urządzeniu.

Zmodyfikuj obsługiwane cechy

  1. Wybierz kartę Traits i kliknij przycisk Edytuj.
  2. W wyskakującym okienku zobaczysz obecnie obsługiwane cechy urządzenia oraz dostępne do dodania. 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 obiektu Home Graph.
  4. Aktualizacje cech możesz przeglądać w obszarze logów.
Ten rysunek przedstawia narzędzie UX służące 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 atrybutu 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 logów.

Dodawanie dodatkowej weryfikacji użytkownika do urządzenia wirtualnego

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ć typ wyzwania oraz odpowiadające mu zachowanie na każdym urządzeniu.

Skonfiguruj dodatkową weryfikację użytkownika 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 zabezpieczającego) na urządzeniu.
    • Typ wyzwania:czy SUV wymaga wyraźnego potwierdzenia (ackNeeded) czy osobistego numeru identyfikacyjnego (pinNeeded).
    • PIN:prawidłowy kod PIN.
    • Obsługa nieprawidłowego kodu PIN: gdy kod PIN jest nieprawidłowy, czy zapytać użytkownika jeszcze raz, a jeśli nie – uzyskać odpowiedź.
Ilustracja pokazująca narzędzie UX, które umożliwia włączenie dodatkowych cech weryfikacji użytkowników na wybranym urządzeniu w Google Home Playground.

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

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, dla których zalecane jest włączenie dodatkowej weryfikacji użytkowników.

Oto lista cech, które 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 przedstawia narzędzie 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 na dole 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 przedstawia narzędzie UX służące do usuwania typu urządzenia wirtualnego z Google Home Playground.

Edytor odpowiedzi synchronizacji

Swoją odpowiedź synchronizacji możesz sprawdzić lub zaktualizować w 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ź z synchronizacji, a następnie kliknij Zapisz, aby zastosować zmiany i przekonać się, jak działa w ekosystemie Google Home.

Ten rysunek pokazuje okno edytowania odpowiedzi synchronizacji.

Importowanie i eksportowanie urządzeń wirtualnych

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

Ilustracja przedstawia narzędzie UX służące do importowania i eksportowania urządzeń wirtualnych do 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 wpiszesz 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 i zaktualizuje informacje oraz stany zaimportowanych urządzeń w narzędziu Home Graph.

Sprawdzanie dzienników interakcji

Gdy korzystasz z urządzeń wirtualnych, Google Home Playground automatycznie stosuje zmianę na tych urządzeniach: Home Graph. Interakcje z Home Graph są rejestrowane w panelu Obszar logów, gdzie możesz rozwinąć każdy wpis, aby zbadać ładunki żądań i odpowiedzi interfejsu 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 URL wywołania interfejsu API Home Graph.
request object Treść żądania wywołania interfejsu API Home Graph. Format poszczególnych metod znajdziesz w dokumentacji dokumentacji.
response object Treść odpowiedzi wywołania interfejsu API Home Graph. Format poszczególnych metod znajdziesz w dokumentacji dokumentacji.

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

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

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

Zgłaszanie problemów

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

Ten rysunek pokazuje ikony przesyłania opinii i zgłaszania problemów w Google Home Playground.