Plac zabaw Google Home

Google Home Playground to aplikacja internetowa, która symuluje projekt inteligentnego domu z możliwością konfigurowania typów i właściwości urządzeń. Możesz tworzyć wirtualne urządzenia, modyfikować ich atrybuty i stany, wyświetlać je na stronie Google Home Graph oraz importować i eksportować ich konfiguracje.

Dokończ łączenie kont

Aby korzystać z Google Home Playground, zalecamy najpierw połączenie narzędzia z kontem. Otwórz aplikację Google Home app (GHA) na telefonie i wykonaj proces łączenia kont:

  1. W lewym górnym rogu kliknij ikonę plusa (+).
  2. Wybierz Skonfiguruj urządzenie > Działa z 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. Kliknij przycisk Autoryzuj, aby autoryzować połączenie konta.
Ilustracja pokazująca proces łączenia konta w aplikacji Google Home w celu połączenia z Google Home Playground

Po zakończeniu łączenia kont na stronie GHA pojawi się zestaw domyślnych urządzeń wirtualnych, z którymi możesz wchodzić w interakcje.

Rysunek przedstawia domyślną listę urządzeń, która jest wypełniana po pomyślnym połączeniu przez użytkownika aplikacji Google Home Playground z jego kontem.

Zaloguj się

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

Uruchom Playground

Kliknij Sign in with Google (Zaloguj się za pomocą konta Google). Aby połączyć konta, zaloguj się na to samo konto, którego użyłeś(-aś) w GHA.

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

Po zalogowaniu się usługa Google Home Playground wyświetli urządzenia wirtualne przechowywane w usłudze 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 urządzenia wirtualne. W tym panelu możesz wybrać określone urządzenie wirtualne, aby wyświetlić jego informacje i utworzyć nowe urządzenia wirtualne.
  • Informacje o urządzeniu zawierają informacje o wybranym urządzeniu wirtualnym. Możesz też edytować te informacje i usunąć wybrane urządzenie wirtualne za pomocą panelu.
  • Obszar logów zawiera logi interakcji między Google Home PlaygroundHome Graph. Możesz rozwinąć dzienniki, aby sprawdzić ładunki żądania i odpowiedzi na potrzeby 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 informacje są podzielone na 5 kart:

  • Podstawowe informacje: właściwości urządzenia na najwyższym poziomie, w tym 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.

Edytowanie informacji o wirtualnym urządzeniu

Oprócz wyświetlania informacji o wirtualnym urządzeniu możesz też bezpośrednio edytować informacje zapisane w Home Graph w panelu Informacje o urządzeniu.

Modyfikowanie obsługiwanych atrybutów

  1. Wybierz kartę Cetras i kliknij przycisk Edytuj.
  2. W wyskakującym okienku zobaczysz obecnie obsługiwane cechy urządzenia oraz dostępne cechy, które możesz dodać. Użyj przycisków strzałka (arrow_forward/arrow_back), aby dodać lub usunąć 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 pokazująca narzędzie UX do dodawania i usuwania obsługiwanych cech na wybranym urządzeniu w Google Home Playground

Modyfikowanie atrybutów urządzenia

  1. Kliknij kartę Atrybuty i edytuj atrybut cech obsługiwanych przez urządzenie.
  2. Po zakończeniu edycji naciśnij Enter, aby zastosować zmiany atrybutów do Home Graph.
  3. Zaktualizowane atrybuty możesz zobaczyć w obszarze dziennika.

Zmiana stanów urządzenia

  1. Wybierz kartę Stan i bezpośrednio edytuj stan. Zmiany stanu zostaną zastosowane do urządzenia 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 do urządzeń wirtualnych i skonfigurować typ wyzwania oraz odpowiednie zachowanie na każdym urządzeniu. Możesz dodać SUV do urządzeń wirtualnych i skonfigurować typ wyzwania oraz odpowiednie zachowanie na każdym urządzeniu.

Konfigurowanie 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 kliknij kartę SUV i skonfiguruj te ustawienia:
    • Włączone: określa, czy funkcja SUV jest włączona czy wyłączona (brak testu) na urządzeniu.
    • Typ wyzwania: czy SUV wymaga potwierdzenia (ackNeeded) czy numeru identyfikacyjnego (pinNeeded).
    • PIN:prawidłowy kod PIN.
    • Obsługa nieprawidłowego kodu PIN: gdy kod PIN jest nieprawidłowy, czy ponownie poprosić użytkownika, a jeśli nie, to jaki błąd wyświetlić.
Ilustracja pokazująca narzędzie UX do włączania cech dodatkowej weryfikacji użytkownika 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 funkcję SUV wyświetla się ikona klucza.

Rysunek przedstawiający urządzenia, na których zaleca się włączenie dodatkowej weryfikacji użytkownika.

Następująca lista cech wymaga SUV:

Tworzenie nowego urządzenia wirtualnego

  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 nowego typu urządzenia 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 kliknij kartę Podstawowe informacje. Następnie w panelu Informacje o urządzeniu kliknij kartę Podstawowe informacje 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 domu Home Graph.
Ilustracja pokazująca narzędzie UX do usuwania typu urządzenia wirtualnego w Google Home Playground.

Edytor odpowiedzi SYNC

Odpowiedź na żądanie synchronizacji możesz zweryfikować lub zaktualizować w Google Home Playground. Aby otworzyć wbudowany IDE, kliknij Edytor odpowiedzi SYNC.

Ilustracja przedstawiająca przycisk otwierający edytor odpowiedzi SYNC.

Zmień lub skopiuj i wklej odpowiedź na synchronizację, a potem kliknij Zapisz, aby zastosować zmiany i zobaczyć, jak działa ona w ekosystemie Google Home.

Ilustracja pokazująca okno do edycji odpowiedzi na żądanie synchronizacji.

Importowanie i eksportowanie urządzeń wirtualnych

Aby rozwiązać lub odtworzyć problemy, możesz wyeksportować urządzenia wirtualne ze stanami do pliku, a następnie 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ć wirtualne urządzenia 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ć wirtualne urządzenia z pliku.
  2. Wybierz plik, który chcesz zaimportować, i kliknij OK.
  3. Gdy potwierdzisz plik do zaimportowania, Google Home Playground zaimportuje z niego wirtualne urządzenia wraz ze stanami oraz zaktualizuje informacje o zaimportowanych urządzeniach i ich stanach w Home Graph.

Sprawdzanie logów interakcji

Gdy korzystasz z urządzeń wirtualnych, Google Home Playgroundautomatycznie stosuje zmiany do Home Graph. Interakcje z Home Graph są rejestrowane w panelu Obszar logów, w którym możesz rozwinąć poszczególne wpisy, aby sprawdzić ładunki żądania i odpowiedzi interfejsu API Home Graph.

Każdy wpis w logu to tablica JSON zawierająca elementy o tej strukturze:

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

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ę. Zgłoś problemy, klikając ikonę wykrzyknika opinie w prawym górnym rogu.

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