Z chmury do chmury Local Home SDK Home APIs
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 opisany w artykule Połącz urządzenia inteligentnego domu innych firm w aplikacji Google Home.
- Wyszukaj integrację o nazwie Google Home Playground.
- Wybierz integrację, a GHA przeniesie Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz konto, na które chcesz się zalogować.
- Kliknij przycisk Autoryzuj, aby autoryzować połączenie konta.

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

Zaloguj się
Uruchom Google Home Playground, klikając przycisk poniżej:
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 programie GHA.

Po zalogowaniu się usługa Google Home Playground wyświetli urządzenia wirtualne przechowywane w usłudze Home Graph.

Interfejs internetowy składa się z 3 paneli:
- Lista urządzeń zawiera wszystkie urządzenia wirtualne. Możesz wybrać konkretne 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. 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 Playground a Home 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 najwyższego poziomu urządzenia, 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
- Kliknij kartę Cechy i kliknij przycisk Edytuj.
- 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. - Po zaktualizowaniu obsługiwanych cech kliknij Zapisz. Zaktualizowane cechy zostaną zastosowane do Home Graph.
- Aktualizacje cech możesz wyświetlić w obszarze dziennika.

Modyfikowanie atrybutów urządzenia
- Kliknij kartę Atrybuty i edytuj atrybut dla cech obsługiwanych przez urządzenie.
- Po zakończeniu edycji naciśnij Enter, aby zastosować zmiany atrybutów do Home Graph.
- Zaktualizowane atrybuty możesz zobaczyć w obszarze dziennika.
Modyfikowanie stanów urządzenia
- Kliknij kartę Stan i bezpośrednio edytuj stan. Zmiany stanu zostaną zastosowane do urządzenia Home Graph.
- 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
- W panelu Lista urządzeń wybierz urządzenie wirtualne, które chcesz skonfigurować.
- 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 wyraźnego potwierdzenia (ackNeeded) czy osobistego 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 o jego podanie, a jeśli nie, to jaki błąd zwrócić.

Identyfikowanie urządzeń, na których dodatkowa weryfikacja użytkownika jest włączona
W panelu Lista urządzeń obok każdego urządzenia obsługującego funkcję SUV wyświetla się ikona klucza.

Następująca lista cech wymaga SUV:
Tworzenie nowego urządzenia wirtualnego
- W panelu Lista urządzeń kliknij Dodaj urządzenie.
- W wyskakującym okienku wybierz typ urządzenia i wpisz jego nazwę. Możesz też wybrać wstępnie zdefiniowany zestaw urządzeń do dodania.
- Po wykonaniu wszystkich czynności nowe urządzenie zostanie dodane do Home Graph.

Usuwanie urządzenia wirtualnego
- 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
Usuń urządzenie.
- Potwierdź usunięcie urządzenia w wyskakującym okienku.
- Gdy potwierdzisz usunięcie urządzenia, zostanie ono usunięte z domu Home Graph.

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

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.

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.

Eksportowanie urządzeń wirtualnych do pliku
- Kliknij , aby wyeksportować wirtualne urządzenia do pliku.
- Wpisz nazwę pliku, który chcesz wyeksportować, i kliknij OK.
- Po wpisaniu nazwy pliku przeglądarka pobierze plik z wyeksportowanymi urządzeniami wirtualnymi.
Importowanie urządzeń wirtualnych z pliku
- Kliknij , aby zaimportować wirtualne urządzenia z pliku.
- Wybierz plik, który chcesz zaimportować, i kliknij OK.
- 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 logach 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 i tej dokumentacji. |
response |
object |
Treść odpowiedzi na wywołanie interfejsu API Home Graph. Format każdej metody znajdziesz w tej dokumentacji i 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.

Zgłaszanie problemów
Chętnie poznamy Twoją opinię. Zgłoś problemy, klikając ikonę znaku zapytania w sekcji opinii w prawym górnym rogu.
