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.
- Wyszukaj integrację zatytułowaną Google Home Playground.
- Wybierz integrację, a GHA przekieruje Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz swoje konto, aby się zalogować.
- Aby autoryzować połączenie kont, kliknij przycisk Autoryzuj.
Po połączeniu konta 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 poniższy przycisk:
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.
Po zalogowaniu się Google Home Playground wyświetli urządzenia wirtualne przechowywane w Home Graph.
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 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ć. 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
- Wybierz kartę Cechy, a potem kliknij przycisk Edytuj.
- 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. - Po zakończeniu aktualizowania obsługiwanych cech kliknij Zapisz, a zaktualizowane cechy zostaną zastosowane do Home Graph.
- Aktualizacje tych atrybutów możesz zobaczyć w obszarze dziennika.
Modyfikuj atrybuty urządzenia
- Kliknij kartę Atrybuty i edytuj atrybut dla cech obsługiwanych przez urządzenie.
- Po zakończeniu edycji naciśnij Enter, a zmiany atrybutów zostaną zastosowane do Home Graph.
- Zaktualizowane atrybuty możesz wyświetlić w obszarze dziennika.
Modyfikowanie stanów urządzeń
- Wybierz kartę Stany i edytuj stan bezpośrednio. Zmiany stanu zostaną zastosowane do urządzenia Home Graph.
- 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
- 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 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ć.
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.
Wymagane są te cechy:
Tworzenie nowego urządzenia wirtualnego
- W panelu Lista urządzeń kliknij Dodaj urządzenie.
- W wyskakującym panelu wybierz typ urządzenia i wpisz jego nazwę. Możesz też wybrać gotowy 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 wybierz kartę Podstawowe informacje i kliknij
Usuń urządzenie u dołu.
- Potwierdź usunięcie urządzenia w wyskakującym alercie.
- Po potwierdzeniu usunięcia urządzenia zostanie ono usunięte z Home Graph.
Edytor odpowiedzi SYNC
Odpowiedź synchronizacji możesz sprawdzić lub zaktualizować w Google Home Playground. Kliknij Edytor odpowiedzi SYNC, aby otworzyć wbudowane środowisko IDE.
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.
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.
Eksportowanie urządzeń wirtualnych do pliku
- Kliknij , aby wyeksportować urządzenia wirtualne do pliku.
- Wpisz nazwę pliku, który chcesz wyeksportować i kliknij OK.
- Po wpisaniu nazwy pliku przeglądarka pobierze plik wyeksportowanych urządzeń wirtualnych.
Importowanie urządzeń wirtualnych z pliku
- Kliknij , aby zaimportować urządzenia wirtualne z pliku.
- Wybierz plik, który chcesz zaimportować i kliknij OK.
- 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 dokumentacji i dokumentacji. |
response |
object |
Treść odpowiedzi wywołania API Home Graph. Format każdej metody znajdziesz w dokumentacji i dokumentacji. |
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.
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.