Plac zabaw Google Home

Interfejsy API Home    w pakiecie Cloud-to-cloud    Local Home SDK

Google Home Playground to aplikacja internetowa, która symuluje projekt inteligentnego domu z konfigurowalnymi typami i cechami 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 korzystać z Google Home Playground, zalecamy najpierw połączenie narzędzia z kontem. Otwórz Google Home app (GHA) na telefonie i wykonaj proces łączenia konta opisany w artykule Łączenie urządzeń inteligentnego domu innych firm w aplikacji Google Home.

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

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

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

Zaloguj się

Aby uruchomić Google Home Playground, kliknij przycisk poniżej:

Uruchom Playground

Kliknij Zaloguj się przez Google. Zaloguj się na to samo konto, którego używasz w aplikacji GHA, aby dokończyć łączenie konta.

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

Po zalogowaniu się w Google Home Playground zostaną wyświetlone 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ń zawiera wszystkie urządzenia wirtualne. Możesz wybrać określone urządzenie wirtualne, aby wyświetlić jego informacje i utworzyć urządzenia wirtualne za pomocą tego panelu.
  • Informacje o urządzeniu zawierają informacje o wybranym urządzeniu wirtualnym. Za pomocą tego panelu możesz też edytować te informacje i usunąć wybrane urządzenie wirtualne.
  • Obszar logów wyświetla logi interakcji między Google Home Playground a Home 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ć. W panelu Informacje o urządzeniu wyświetlą się informacje o nim podzielone na 5 kart:

  • Podstawowe informacje:właściwości najwyższego poziomu urządzenia, w tym typ, identyfikator i nazwa.
  • Cechy:obsługiwane cechy urządzenia.
  • Atrybuty:atrybuty urządzenia specyficzne dla cechy.
  • Stany:wszystkie stany urządzenia.
  • SUV: Konfiguracja dodatkowej weryfikacji użytkownika na urządzeniu.

Edytowanie informacji o urządzeniu wirtualnym

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

Modyfikowanie obsługiwanych cech

  1. Kliknij kartę Cechy , a potem przycisk Edytuj.
  2. W wyskakującym okienku zobaczysz obecnie obsługiwane cechy urządzenia oraz cechy, które można dodać. Aby dodać lub usunąć obsługiwane cechy urządzenia, użyj przycisków strzałek (arrow_forward/arrow_back).
  3. Po zaktualizowaniu obsługiwanych cech kliknij Zapisz, a zaktualizowane cechy zostaną zastosowane w Home Graph.
  4. Te aktualizacje cech możesz zobaczyć w Obszarze logów.
Ilustracja przedstawia 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, a zmiany atrybutów zostaną zastosowane w Home Graph.
  3. Te zaktualizowane atrybuty możesz zobaczyć w Obszarze logów.

Modyfikowanie stanów urządzenia

  1. Kliknij kartę Stany i edytuj stan bezpośrednio. Zmiany stanu zostaną zastosowane w Home Graph.
  2. Te modyfikacje stanu możesz zobaczyć w Obszarze logów.

Dodawanie dodatkowej weryfikacji użytkownika do urządzenia wirtualnego

Możesz dodać dodatkową weryfikację użytkownika do urządzeń wirtualnych i skonfigurować jej typ wyzwania oraz odpowiednie zachowanie na każdym urządzeniu. Możesz dodać dodatkową weryfikację użytkownika do urządzeń wirtualnych i skonfigurować jej typ wyzwania 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 (bez wyzwania) na urządzeniu.
    • Typ wyzwania: czy dodatkowa weryfikacja użytkownika wymaga wyraźnego potwierdzenia (ackNeeded) czy osobistego numeru identyfikacyjnego (pinNeeded).
    • PIN:prawidłowy kod PIN.
    • Obsługa nieprawidłowego kodu PIN:czy w przypadku nieprawidłowego kodu PIN należy ponownie zapytać użytkownika, a jeśli nie, to jaki błąd należy 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, na którym włączona jest dodatkowa weryfikacja użytkownika, wyświetla się ikona klucza key.

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

Ta lista cech wymaga dodatkowej weryfikacji użytkownika:

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 przedstawia 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 , a potem 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 przedstawia narzędzie UX do usuwania typu urządzenia wirtualnego w Google Home Playground.

Edytor odpowiedzi SYNC

W Google Home Playground możesz zweryfikować lub zaktualizować odpowiedź SYNC. Aby otworzyć wbudowane środowisko IDE, kliknij Edytor odpowiedzi SYNC.

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

Edytuj lub skopiuj i wklej odpowiedź SYNC, a potem 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 powielić 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. Aby wyeksportować urządzenia wirtualne do pliku, kliknij .
  2. Wpisz nazwę pliku, który chcesz wyeksportować, i kliknij OK.
  3. Gdy wpiszesz nazwę pliku, przeglądarka pobierze plik wyeksportowanych urządzeń wirtualnych.

Importowanie urządzeń wirtualnych z pliku

  1. Aby zaimportować urządzenia wirtualne z pliku, kliknij .
  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 oraz zaktualizuje informacje i stany zaimportowanych urządzeń w Home Graph.

Sprawdzanie logów interakcji

Gdy wchodzisz w interakcje z urządzeniami wirtualnymi, Google Home Playground automatycznie stosuje zmiany w Home Graph. The interakcje z Home Graph są rejestrowane w panelu Obszar logów , w którym możesz rozwinąć każdy wpis, aby sprawdzić ładunki żądań do interfejsu Home Graph API i odpowiedzi.

Każdy wpis 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 Home Graph API.
request object Treść żądania wywołania interfejsu Home Graph API. Format każdej metody znajdziesz w dokumentacji dokumentacji.
response object Treść odpowiedzi wywołania interfejsu Home Graph API. Format każdej metody znajdziesz w dokumentacji dokumentacji.

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

W prawym górnym rogu kliknij ikonę znaku zapytania help , aby wyświetlić bieżącą listę typów i cech urządzeń obsługiwanych przez Google Home Playground.

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

Zgłaszanie problemów

Chcemy poznać Twoją opinię! Aby zgłosić napotkane problemy, w prawym górnym rogu kliknij ikonę wykrzyknika feedback.

Ilustracja przedstawiająca ikony przesyłania opinii i zgłaszania problemów w Google Home Playground.