Plac zabaw Google Home

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

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 na telefonie aplikację Google Home app (GHA) i przeprowadź 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ę

Aby uruchomić Google Home Playground, kliknij 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.

Rysunek przedstawia listę urządzeń, informacje o urządzeniu i obszar dziennika w widoku domyślnym 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 cechami.
  • Stany: wszystkie stany urządzenia.
  • SUV: konfiguracja dodatkowej weryfikacji użytkownika na urządzeniu.

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. Kliknij kartę Cechy 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 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.

Modyfikowanie stanów urządzenia

  1. Kliknij kartę Stan i bezpośrednio edytuj stan. Zmiany stanu zostaną zastosowane do urządzenia Home Graph.
  2. Te zmiany stanu możesz zobaczyć w obszarze dziennika.

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łączona:czy dodatkowa weryfikacja użytkownika jest włączona (brak wyzwania) 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: jeśli kod PIN jest nieprawidłowy, czy ponownie poprosić użytkownika, a jeśli nie, to jaką zwrócić odpowiedź.
Ilustracja pokazująca narzędzie UX do włączania cech dodatkowej weryfikacji użytkownika na wybranym urządzeniu w Google Home Playground

Identyfikowanie urządzeń, na których włączono dodatkową weryfikację użytkownika

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

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. Kliknij Edytor odpowiedzi SYNC, aby otworzyć wbudowane środowisko IDE.

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ązywać problemy lub je odtwarzać, możesz wyeksportować urządzenia wirtualne wraz z ich stanem do pliku i udostępnić go innym osobom, aby zaimportować i zduplikować urządzenia wirtualne.

Ilustracja pokazująca narzędzie UX do importowania i eksportowania wirtualnych urządzeń 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, a także zaktualizuje informacje o zaimportowanych urządzeniach i ich stany 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 każdej metody znajdziesz w tej dokumentacji.
response object Treść odpowiedzi na wywołanie interfejsu API Home Graph. Format każdej metody znajdziesz w tej dokumentacji.

Wyświetlanie obsługiwanych typów i traits urządzeń

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

Ilustracja pokazująca narzędzie UX do dodawania nowego typu urządzenia 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 przedstawiająca ikony służące do przesyłania opinii i zgłaszania problemów w Google Home Playground.