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.
- Wyszukaj integrację o nazwie Google Home Playground.
- Wybierz integrację, a aplikacja Google Home przekieruje Cię na stronę logowania.GHA Kliknij Zaloguj się przez Google i wybierz konto, aby się zalogować.
- Aby autoryzować łączenie konta, kliknij przycisk Autoryzuj.
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
Zaloguj się
Aby uruchomić Google Home Playground, kliknij przycisk poniżej:
Kliknij Zaloguj się przez Google. Zaloguj się na to samo konto, którego używasz w aplikacji GHA, aby dokończyć łączenie konta.
Po zalogowaniu się w Google Home Playground zostaną wyświetlone urządzenia wirtualne przechowywane w Home Graph.
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
- Kliknij kartę Cechy , a potem przycisk Edytuj.
- 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) . - Po zaktualizowaniu obsługiwanych cech kliknij Zapisz, a zaktualizowane cechy zostaną zastosowane w Home Graph.
- Te aktualizacje cech możesz zobaczyć w Obszarze logów.
Modyfikowanie atrybutów urządzenia
- Kliknij kartę Atrybuty i edytuj atrybut cech obsługiwanych przez urządzenie.
- Po zakończeniu edycji naciśnij Enter, a zmiany atrybutów zostaną zastosowane w Home Graph.
- Te zaktualizowane atrybuty możesz zobaczyć w Obszarze logów.
Modyfikowanie stanów urządzenia
- Kliknij kartę Stany i edytuj stan bezpośrednio. Zmiany stanu zostaną zastosowane w Home Graph.
- 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
- 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 (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ć.
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 lista cech wymaga dodatkowej weryfikacji użytkownika:
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 , a potem 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 Home Graph.
Edytor odpowiedzi SYNC
W Google Home Playground możesz zweryfikować lub zaktualizować odpowiedź SYNC. Aby otworzyć wbudowane środowisko IDE, kliknij 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.
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.
Eksportowanie urządzeń wirtualnych do pliku
- Aby wyeksportować urządzenia wirtualne do pliku, kliknij .
- Wpisz nazwę pliku, który chcesz wyeksportować, i kliknij OK.
- Gdy wpiszesz nazwę pliku, przeglądarka pobierze plik wyeksportowanych urządzeń wirtualnych.
Importowanie urządzeń wirtualnych z pliku
- Aby zaimportować urządzenia wirtualne z pliku, kliknij .
- 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.
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.
Zgłaszanie problemów
Chcemy poznać Twoją opinię! Aby zgłosić napotkane problemy, w prawym górnym rogu kliknij ikonę wykrzyknika feedback.