Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

Plac zabaw Google Home

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Pakiet SDK urządzenia

Google Home Playground to aplikacja internetowa, która symuluje projekt inteligentnego domu, symulując wirtualny dom z konfigurowanymi typami i cechami. Home Playground pozwala tworzyć urządzenia wirtualne, modyfikować atrybuty i stany urządzeń, wyświetlać te urządzenia w usłudze Google Home Graph oraz importować i eksportować konfiguracje urządzeń.

Dokończ łączenie kont

Aby korzystać z narzędzia Home Playground, zalecamy najpierw połączenie narzędzia z kontem. Otwórz aplikację Google Home app (GHA) na telefonie i wykonaj proces łączenia kont:

  1. Kliknij ikonę plusa w lewym górnym rogu.
  2. Wybierz Skonfiguruj urządzenie > Współpracuje z Google.
  3. Wyszukaj działanie Google Home Playground.
  4. Wybierz działanie, a GHA przekieruje Cię na stronę logowania. Kliknij Zaloguj się przez Google i wybierz swoje konto.
  5. Kliknij przycisk Autoryzuj, aby autoryzować połączenie kont.
Ten rysunek przedstawia proces łączenia kont Google Home w celu połączenia Google Play Playground.

Po połączeniu kont na urządzeniu GHA pojawi się zestaw domyślnych urządzeń wirtualnych, z którymi możesz się komunikować.

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

Logowanie się

Uruchom aplikację Home Playground, klikając przycisk poniżej:

Uruchom Playground

Kliknij Sign in with Google (Zaloguj się za pomocą konta Google). Aby dokończyć łączenie, pamiętaj, aby zalogować się na konto, którego używasz w GHA.

Ta wartość pokazuje początkowy stan Google Play Playground i wyróżnia przycisk logowania w prawym górnym rogu.

Gdy się zalogujesz, Home Playground wyświetli listę urządzeń wirtualnych przechowywanych w Home Graph.

Ta ikona pokazuje listę urządzeń, informacje o nim i obszar logów w domyślnym widoku Google Home Playground.

Interfejs internetowy składa się z 3 paneli:

  • Lista urządzeń pokazuje wszystkie urządzenia wirtualne. Możesz wybrać określone urządzenie wirtualne, aby wyświetlić informacje na jego temat i utworzyć urządzenia wirtualne w tym panelu.
  • Informacje o urządzeniu – informacje o wybranym urządzeniu wirtualnym. Możesz też edytować te informacje i usunąć wybrane urządzenie wirtualne za pomocą panelu.
  • Obszar logów wyświetla logi interakcji między Home Playground a Home Graph. Możesz rozwinąć logi, aby sprawdzić ładunki 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ć. Panel Informacje o urządzeniu podzielony jest na 5 kart:

  • Informacje podstawowe: właściwości najwyższego poziomu urządzenia, w tym typ, identyfikator i nazwa urządzenia.
  • Cechy charakterystyczne: obsługiwane cechy urządzenia.
  • Atrybuty: atrybuty urządzenia.
  • Stany: wszystkie stany urządzeń.
  • SUV: konfiguracja dodatkowej weryfikacji użytkownika urządzenia.

Edytuj informacje o urządzeniu wirtualnym

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

Zmień obsługiwane cechy

  1. Wybierz kartę Traits (Trasy) i kliknij przycisk Edit (Edytuj).
  2. W wyskakującym okienku zobaczysz obsługiwane cechy urządzenia oraz cechy, które możesz dodać. Użyj przycisków strzałek (arrow_forward/arrow_back), aby dodać lub usunąć cechy obsługiwane przez urządzenie.
  3. Po zaktualizowaniu obsługiwanych cech, kliknij Zapisz. Zaktualizowane atrybuty zostaną zastosowane do Home Graph.
  4. Możesz je zobaczyć w obszarze dziennika.
Ten rysunek przedstawia narzędzie UX do dodawania i usuwania obsługiwanych cech na wybranym urządzeniu w Google Home Playground.

Modyfikowanie atrybutów urządzeń

  1. Wybierz kartę Informacje/atrybuty podstawowe i edytuj atrybuty obsługiwane przez urządzenie.
  2. Po zakończeniu edytowania naciśnij Enter, a zmiany atrybutów zostaną zastosowane do elementów (Home Graph).
  3. Zaktualizowane atrybuty możesz wyświetlić w obszarze dziennika.

Modyfikowanie stanu urządzenia

  1. Wybierz kartę Stany i edytuj stan bezpośrednio. Zmiany stanu zostaną zastosowane do Home Graph.
  2. Te zmiany stanu możesz zobaczyć w obszarze dziennika.

Dodawanie dodatkowej weryfikacji użytkownika do urządzenia wirtualnego

Możesz dodać SUV-a do urządzeń wirtualnych i skonfigurować typ wyzwania oraz odpowiadające mu zachowanie na każdym urządzeniu.

Skonfiguruj SUV-a na urządzeniu

  1. W panelu Lista urządzeń wybierz urządzenie wirtualne, które chcesz skonfigurować.
  2. W panelu Informacje o urządzeniu wybierz kartę SUV i skonfiguruj te ustawienia:
    • Włączone: czy SUV-a jest włączona czy wyłączona (brak wyzwania) na urządzeniu.
    • Typ wyzwania:czy SUV wymaga wyraźnego potwierdzenia (ackNeeded) lub osobistego numeru identyfikacyjnego (pinNeeded).
    • Kod PIN: prawidłowy kod PIN.
    • Postępowanie w przypadku nieprawidłowego kodu PIN: gdy użytkownik poda nieprawidłowy kod PIN, czy poprosić użytkownika o ponowny kontakt, a w razie potrzeby poznać odpowiedź.
Ten rysunek pokazuje narzędzie UX umożliwiające włączenie cech dodatkowych użytkowników weryfikacyjnych na wybranym urządzeniu w Google Play Play.

Identyfikowanie urządzeń umożliwiających korzystanie z SUV-a

W panelu Lista urządzeń ikona klucza klucza wyświetli się obok każdego urządzenia obsługującego SUV-a.

Ta ikona pokazuje urządzenia, które powinny być włączone, aby umożliwić dodatkową weryfikację użytkowników.

Poniższa lista cech wymaga SUV-a:

Utwórz nowe urządzenie wirtualne

  1. W panelu Lista urządzeń kliknij Dodaj urządzenie.
  2. W wyskakującym okienku wybierz typ urządzenia i wpisz nazwę nowego urządzenia. Możesz też wybrać wstępnie zdefiniowany zestaw urządzeń.
  3. Gdy wykonasz wszystkie te czynności, do Home Graph zostanie dodane nowe urządzenie.
Ten rysunek pokazuje narzędzie UX umożliwiające dodanie 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 wybierz kartę Podstawowe informacje i kliknij Ikona koszaUsuń urządzenie u dołu.
  2. Potwierdź usunięcie urządzenia w wyskakującym okienku.
  3. Gdy potwierdzisz, że urządzenie zostało usunięte, zostanie ono usunięte z urządzenia Home Graph.
Ten rysunek przedstawia narzędzie UX do usuwania typu urządzenia wirtualnego w Google Home Playground.

Importowanie i eksportowanie urządzeń wirtualnych

Aby rozwiązać problemy lub odtworzyć problemy, możesz wyeksportować urządzenia wirtualne do stanu i udostępnić je innym osobom, aby móc je zaimportować i zreplikować.

Ten rysunek przedstawia narzędzie UX do importowania i eksportowania urządzeń wirtualnych w Google Home Playground.

Eksportuj urządzenia wirtualne do pliku

  1. Kliknij , aby wyeksportować do urządzenia urządzenia wirtualne.
  2. Wpisz nazwę pliku, który chcesz wyeksportować, a potem kliknij OK.
  3. Gdy wpiszesz nazwę pliku, przeglądarka pobierze plik wyeksportowanych urządzeń wirtualnych.

Importuj urządzenia wirtualne z pliku

  1. Kliknij , aby zaimportować z urządzenia pliki wirtualne.
  2. Wybierz plik, który chcesz zaimportować, a potem kliknij OK.
  3. Gdy potwierdzisz plik, który chcesz zaimportować, Home Playground zaimportuje urządzenia wirtualne ze stanami oraz zaktualizuje informacje i stan urządzeń z Home Graph.

Sprawdzanie dzienników interakcji

Gdy korzystasz z urządzeń wirtualnych, Home Playground automatycznie stosuje zmianę na urządzeniu Home Graph. Interakcje z Home Graph są rejestrowane w panelu Obszar logów, w którym możesz rozwinąć każdy wpis, aby sprawdzić ładunki i żądanie odpowiedzi Home Graph w interfejsie API.

Każdy wpis w logu jest tablicą JSON zawierającą 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 interfejsu API Home Graph. Format każdej z nich znajdziesz w dokumentacji referencyjnej.
response object Treść odpowiedzi na wywołanie interfejsu API Home Graph. Format każdej z nich znajdziesz w dokumentacji referencyjnej.

Zobacz obsługiwane typy urządzeń i ich cechy

Ikona znaku zapytania pomocy w prawym górnym rogu wyświetla aktualny typ urządzenia i listę cech obsługiwane przez Home Playground.

Ten rysunek pokazuje narzędzie UX umożliwiające dodanie nowego typu urządzenia w Google Home Playground.

Przesyłanie opinii i zgłaszanie problemów

Chętnie poznamy Twoją opinię. Aby przesłać nam swoją opinię, kliknij ikonę z buźką sentiment_sconfified w prawym górnym rogu lub zgłoś napotkany problem, klikając ikonę wykrzyknika opinię.

Ta ikona pokazuje ikony umożliwiające przesyłanie opinii i zgłaszanie problemów w Google Home Playground.