Z chmury do chmury Pakiet SDK Local Home Pakiet SDK urządzenia
Google Home Playground to aplikacja internetowa symulująca inteligentny projekt domowy z konfigurowalnymi typami urządzeń i cechami. Możesz tworzyć urządzenia wirtualne, modyfikować ich atrybuty i stany, wyświetlać je w Google Home Graph oraz importować i eksportować ich konfiguracje.
Dokończ łączenie kont
Zalecamy, aby najpierw połączyć narzędzie z kontem, aby używać narzędzia Google Home Playground. Otwórz aplikację Google Home app (GHA) na telefonie i wykonaj proces łączenia kont:
- Kliknij ikonę plusa (+) w lewym górnym rogu.
- Wybierz Skonfiguruj urządzenie > Obsługiwane przez Google.
- Wyszukaj działanie o nazwie Google Home Playground.
- Wybierz działanie, a GHA przekieruje Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz konto, na które chcesz się zalogować.
- Aby autoryzować połączenie kont, kliknij przycisk Autoryzuj.
![Ilustracja pokazująca proces łączenia konta w aplikacji Google Home w celu połączenia Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-app-login-flow.png?authuser=4&hl=pl)
Gdy zakończysz łączenie kont, na urządzeniu GHA pojawi się zestaw domyślnych urządzeń wirtualnych, z których możesz korzystać.
![Ten rysunek przedstawia domyślną listę urządzeń, która wypełnia się, gdy użytkownik połączy Playground Google Home ze swoim kontem.](https://developers.home.google.com/static/tools/images/playground-default-devices.png?authuser=4&hl=pl)
Zaloguj się
Uruchom Google Home Playground, klikając przycisk poniżej:
Kliknij Zaloguj się przez Google. Pamiętaj, aby zalogować się na konto, którego używasz w aplikacji GHA do dokończenia łączenia kont.
![Ilustracja przedstawia początkowy stan Google Home Playground i wyróżnia przycisk logowania w prawym górnym rogu.](https://developers.home.google.com/static/tools/images/playground-signin.png?authuser=4&hl=pl)
Gdy się zalogujesz, na stronie Google Home Playground pojawią się urządzenia wirtualne zapisane w aplikacji Home Graph.
![Ten rysunek przedstawia listę urządzeń, informacje o urządzeniu i obszar dziennika w domyślnym widoku aplikacji Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-sections.png?authuser=4&hl=pl)
Interfejs internetowy składa się z 3 paneli:
- Lista urządzeń zawiera wszystkie Twoje urządzenia wirtualne. W panelu możesz wybrać konkretne urządzenie wirtualne, aby wyświetlić o nim informacje i utworzyć takie urządzenia.
- Informacje o urządzeniu zawierają informacje o wybranym urządzeniu wirtualnym. Możesz też edytować te informacje i usunąć wybrane urządzenie wirtualne w panelu.
- Obszar logu: wyświetla dzienniki interakcji między Google Home Playground a Home Graph. Możesz rozwinąć logi, aby zbadać ładunki żądań i odpowiedzi pod kątem rozwiązywania problemów.
Urządzenie wirtualne
Wyświetl informacje 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ć. Informacje o urządzeniu są wyświetlane w panelu Informacje o urządzeniu, podzielone na pięć kart:
- Informacje podstawowe: najważniejsze właściwości urządzenia, w tym jego 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.
Edytuj informacje o urządzeniu wirtualnym
Panel Informacje o urządzeniu pozwala nie tylko wyświetlać informacje o urządzeniu wirtualnym, ale też bezpośrednio edytować ich dane przechowywane w usłudze Home Graph.
Zmodyfikuj obsługiwane cechy
- Wybierz kartę Cetras i kliknij przycisk Edytuj.
- W wyskakującym okienku zobaczysz cechy urządzenia, które są obecnie obsługiwane, oraz te, które możesz dodać. Za pomocą przycisków strzałki
(arrow_forward/arrow_back) dodaj lub usuń obsługiwane cechy urządzenia. - Po zaktualizowaniu obsługiwanych cech kliknij Zapisz. Zaktualizowane cechy zostaną zastosowane do modelu Home Graph.
- Aktualizacje cech możesz wyświetlić w obszarze dziennika.
![Ilustracja przedstawia narzędzie UX służące do dodawania i usuwania obsługiwanych cech na wybranym urządzeniu w Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-modify-traits.png?authuser=4&hl=pl)
Modyfikowanie atrybutów urządzenia
- Wybierz kartę Atrybuty i edytuj atrybut cech obsługiwanych przez urządzenie.
- Po zakończeniu edytowania naciśnij Enter, a zmiany atrybutów zostaną zastosowane do Home Graph.
- Zaktualizowane atrybuty możesz wyświetlić w Obszarze logów.
Modyfikowanie stanów urządzeń
- Wybierz kartę Stany i bezpośrednio edytuj stan. Zmiany stanu zostaną zastosowane do obszaru Home Graph.
- Te zmiany stanu możesz wyświetlić w obszarze logów.
Dodawanie dodatkowej weryfikacji użytkownika na urządzeniu wirtualnym
Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować jego typ testu zabezpieczającego oraz odpowiadające mu działanie na każdym urządzeniu. Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować jego typ testu zabezpieczającego oraz odpowiadające mu działanie na każdym urządzeniu.
Skonfiguruj SUV-a na urządzeniu
- W panelu Lista urządzeń wybierz urządzenie wirtualne, które chcesz skonfigurować.
- W panelu Informacje o urządzeniu wybierz kartę SUV i skonfiguruj te ustawienia:
- Włączone: określa, czy funkcja SUV jest włączona czy wyłączona (brak testu) na urządzeniu.
- Rodzaj wyzwania: czy SUV wymaga jednoznacznego potwierdzenia (ackNeeded) czy osobisty numer identyfikacyjny (pinNeeded).
- PIN:prawidłowy kod PIN.
- Obsługa nieprawidłowego kodu PIN: gdy kod PIN jest błędny – czy ponownie poprosić użytkownika o odpowiedź, a jeśli nie, czy otrzymać komunikat o błędzie.
![Ilustracja przedstawia narzędzie UX umożliwiające włączenie dodatkowych cech weryfikacji użytkowników na wybranym urządzeniu w Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-SUV.png?authuser=4&hl=pl)
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 SUV-a wyświetla się ikona klucza klucz.
![Na tym rysunku znajdują się urządzenia, na których zalecamy włączenie dodatkowej weryfikacji użytkownika.](https://developers.home.google.com/static/tools/images/playground-enable-SUV.png?authuser=4&hl=pl)
Ta lista cech wymaga SUV-a:
Utwórz nowe urządzenie wirtualne
- 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.
![Ilustracja pokazująca narzędzie UX do dodawania urządzeń nowego typu w Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-add-device.png?authuser=4&hl=pl)
Usuwanie urządzenia wirtualnego
- W panelu Lista urządzeń wybierz urządzenie, które chcesz usunąć.
Następnie w panelu Informacje o urządzeniu wybierz kartę Informacje podstawowe, a następnie w panelu Informacje o urządzeniu wybierz kartę Informacje podstawowe i kliknij
Usuń urządzenie u dołu.
- Potwierdź usunięcie urządzenia w wyskakującym okienku.
- Gdy potwierdzisz usunięcie urządzenia, zostanie ono usunięte z Home Graph.
![Ilustracja przedstawia narzędzie UX do usunięcia typu urządzenia wirtualnego w Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-remove-device.png?authuser=4&hl=pl)
Edytor odpowiedzi na synchronizację
Możesz zweryfikować lub zaktualizować odpowiedź synchronizacji w Google Home Playground. Kliknij Sync Response Editor (Edytor odpowiedzi synchronizacji), aby otworzyć osadzone IDE.
![Ten rysunek przedstawia przycisk otwierający edytor odpowiedzi synchronizacji.](https://developers.home.google.com/static/tools/images/playground-sync-response-editor.png?authuser=4&hl=pl)
Edytuj lub skopiuj i wklej odpowiedź synchronizacji, a następnie kliknij Zapisz, aby zastosować zmiany i zobaczyć, jak działa ona w ekosystemie Google Home.
![Ten rysunek przedstawia okno edytowania odpowiedzi synchronizacji.](https://developers.home.google.com/static/tools/images/playground-sync-response-window.png?authuser=4&hl=pl)
Importowanie i eksportowanie urządzeń wirtualnych
Aby rozwiązać lub odtworzyć problemy, możesz wyeksportować urządzenia wirtualne ze stanami do pliku, a potem 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.](https://developers.home.google.com/static/tools/images/playground-import-export.png?authuser=4&hl=pl)
Eksportowanie urządzeń wirtualnych do pliku
- Kliknij , aby wyeksportować urządzenia wirtualne do pliku.
- Wpisz nazwę pliku, który chcesz wyeksportować, i kliknij OK.
- Gdy podasz nazwę pliku, przeglądarka pobierze plik z wyeksportowanymi urządzeniami wirtualnymi.
Importuj urządzenia wirtualne z pliku
- Kliknij , aby zaimportować urządzenia wirtualne z pliku.
- Wybierz plik, który chcesz zaimportować, i kliknij OK.
- 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.
Sprawdź dzienniki interakcji
Gdy wchodzisz w interakcję z urządzeniami wirtualnymi, Google Home Playground automatycznie wprowadza zmianę w Home Graph. Interakcje z funkcją Home Graph są rejestrowane w panelu Obszar logu, gdzie możesz rozwinąć każdy wpis, aby przeanalizować ładunki żądań i odpowiedzi do interfejsu API Home Graph.
Każdy wpis logu jest tablicą JSON zawierającą elementy o następującej 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 poszczególnych metod znajdziesz w dokumentacji referencyjnej dokumentacji referencyjnej. |
response |
object |
Treść odpowiedzi wywołania interfejsu API Home Graph. Format poszczególnych metod znajdziesz w dokumentacji referencyjnej dokumentacji referencyjnej. |
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.](https://developers.home.google.com/static/tools/images/playground-supported-devices.png?authuser=4&hl=pl)
Zgłaszanie problemów
Chętnie poznamy Twoją opinię. Wystąpiły problemy podczas zgłaszania problemów, korzystając z ikony wykrzyknika opinii w prawym górnym rogu.
![Ilustracja przedstawia ikony umożliwiające przesyłanie opinii i zgłaszanie problemów w Google Home Playground.](https://developers.home.google.com/static/tools/images/playground-feedback.png?authuser=4&hl=pl)