Plac zabaw Google Home

Cloud-to-cloud    Local Home SDK    Home APIs

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

Dokończ łączenie konta

Aby móc korzystać z Google Home Playground, zalecamy najpierw połączyć narzędzie ze swoim kontem. Otwórz aplikację Google Home app (GHA) na telefonie i wykonaj procedurę łączenia kont opisaną w artykule Podłączanie inteligentnych urządzeń domowych innych firm w aplikacji Google Home.

  1. Wyszukaj integrację zatytułowaną Google Home Playground.
  2. Wybierz integrację, a GHA przekieruje Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz swoje konto, aby się zalogować.
  3. Aby autoryzować połączenie kont, kliknij przycisk Autoryzuj.
Ilustracja przedstawia proces łączenia konta w aplikacji Google Home w celu połączenia z Google Home Playground.

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

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

Zaloguj się

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

Uruchom Playground

Kliknij Sign in with Google (Zaloguj się za pomocą konta Google). Zaloguj się na to samo konto, którego używasz w GHA, aby dokończyć łączenie kont.

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 przechowywane w Home Graph.

Ilustracja 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ń wyświetla wszystkie Twoje urządzenia wirtualne. Możesz wybrać określone urządzenie wirtualne, aby wyświetlić jego informacje i utworzyć urządzenia wirtualne w tym panelu.
  • Informacje o urządzeniu zawierają informacje o wybranym urządzeniu wirtualnym. Informacje te można również edytować i usunąć wybrane urządzenie wirtualne za pośrednictwem panelu.
  • Obszar dziennika wyświetla dzienniki interakcji między Google Home PlaygroundHome Graph. Możesz rozwinąć logi, aby sprawdzić ładunki żądań i odpowiedzi w celu rozwiązania 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ć. Panel Informacje o urządzeniu będzie zawierał informacje podzielone na pięć zakładek:

  • Podstawowe informacje: właściwości najwyższego poziomu urządzenia, w tym typ, identyfikator i nazwa urządzenia.
  • Cechy: obsługiwane cechy urządzenia.
  • Atrybuty: atrybuty urządzenia związane z określonymi 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 o nim przechowywane w Home Graph za pomocą panelu Informacje o urządzeniu.

Modyfikowanie obsługiwanych cech

  1. Wybierz kartę Cechy, a potem kliknij przycisk Edytuj.
  2. W wyskakującym panelu zobaczysz obecnie obsługiwane cechy urządzenia i cechy, które można dodać. Użyj przycisków strzałek (arrow_forward/arrow_back), aby dodać lub usunąć obsługiwane cechy urządzenia.
  3. Po zakończeniu aktualizowania obsługiwanych cech kliknij Zapisz, a zaktualizowane cechy zostaną zastosowane do Home Graph.
  4. Aktualizacje tych atrybutów możesz zobaczyć w obszarze dziennika.
Ilustracja przedstawia narzędzie UX do dodawania lub usuwania obsługiwanych cech na wybranym urządzeniu w Google Home Playground.

Modyfikuj atrybuty urządzenia

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

Modyfikowanie stanów urządzeń

  1. Wybierz kartę Stany i edytuj stan bezpośrednio. Zmiany stanu zostaną zastosowane do urządzenia Home Graph.
  2. Zmiany stanu można przeglądać w obszarze dziennika.

Dodaj dodatkową weryfikację użytkownika do urządzenia wirtualnego

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

Konfigurowanie dodatkowej weryfikacji 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 kliknij kartę SUV i skonfiguruj te ustawienia:
    • Włączona:czy dodatkowa weryfikacja użytkownika jest włączona czy wyłączona (brak weryfikacji) na urządzeniu.
    • Typ weryfikacji: 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 ponownie poprosić użytkownika o jego podanie, a jeśli nie, to jaki błąd zwrócić.
Ilustracja przedstawiająca narzędzie UX do włączania cech dodatkowej weryfikacji użytkownika na wybranym urządzeniu w Google Home Playground.

Identyfikowanie urządzeń, które umożliwiają dodatkową weryfikację użytkownika

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

Ta ilustracja przedstawia urządzenia, na których zalecamy włączenie dodatkowej weryfikacji użytkownika.

Wymagane są te cechy:

Tworzenie nowego urządzenia wirtualnego

  1. W panelu Lista urządzeń kliknij Dodaj urządzenie.
  2. W wyskakującym panelu wybierz typ urządzenia i wpisz jego nazwę. Możesz też wybrać gotowy zestaw urządzeń do dodania.
  3. Po wykonaniu wszystkich czynności nowe urządzenie zostanie dodane do Home Graph.
Ilustracja przedstawiają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 wybierz kartę Podstawowe informacje i kliknij Ikona koszaUsuń urządzenie u dołu.
  2. Potwierdź usunięcie urządzenia w wyskakującym alercie.
  3. Po potwierdzeniu usunięcia urządzenia zostanie ono usunięte z Home Graph.
Ilustracja przedstawia narzędzie UX do usuwania wirtualnego typu urządzenia w Google Home Playground.

Edytor odpowiedzi SYNC

Odpowiedź synchronizacji możesz sprawdzić lub zaktualizować w Google Home Playground. Kliknij Edytor odpowiedzi SYNC, aby otworzyć wbudowane środowisko IDE.

Ilustracja przedstawia przycisk otwierający edytor odpowiedzi SYNC.

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

Ilustracja przedstawiająca okno edycji odpowiedzi synchronizacji.

Importowanie i eksportowanie urządzeń wirtualnych

Aby rozwiązywać problemy lub je odtwarzać, możesz wyeksportować urządzenia wirtualne wraz z ich stanami do pliku i udostępnić go innym osobom, aby mogły zaimportować i odtworzyć Twoje urządzenia wirtualne.

Ilustracja przedstawiają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ć 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 wyeksportowanych urządzeń wirtualnych.

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. Po potwierdzeniu pliku do zaimportowania usługa Google Home Playground zaimportuje urządzenia wirtualne ze stanami z pliku i zaktualizuje informacje o zaimportowanych urządzeniach oraz ich stany w usłudze Home Graph.

Sprawdzanie logów interakcji

Gdy korzystasz z wirtualnych urządzeń, Google Home Playground automatycznie stosuje zmiany w Home Graph. Interakcje z Home Graph są rejestrowane w panelu Obszar dziennika, w którym możesz rozwinąć każdy wpis, aby sprawdzić ładunki żądań 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 wywołania interfejsu API Home Graph. Format każdej metody znajdziesz w dokumentacjidokumentacji.
response object Treść odpowiedzi wywołania API Home Graph. Format każdej metody znajdziesz w dokumentacjidokumentacji.

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

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

Na tym rysunku pokazano narzędzie UX służące do dodawania nowego typu urządzenia w Google Home Playground.

Zgłaszanie problemów

Chcielibyśmy usłyszeć Twoją opinię! Zgłaszaj napotkane problemy, korzystając z ikony wykrzyknika opinii w prawym górnym rogu.

Na tym rysunku pokazano ikony służące do przesyłania opinii i zgłaszania problemów w usłudze Google Home Playground.