AIS Google Home

Wprowadzenie

AIS Google Home jest to integracja Asystenta domowego z platformą programistyczną dla Asystenta Google. Integracja działa poprzez oficjalne Google Assistant SDK i pozwala na konwersację z Asystentem Google z poziomu Asystenta domowego.

Integracja

Aby skonfigurować AIS Google Home, przejdź do konfiguracji a następnie do panelu integracji. Naciśnij pomarańczowy przycisk z ikonką "plus" w prawym dolnym rogu ekranu, żeby otworzyć listę dostępnych integracji. Wybierz z listy integrację AIS Google Home

JSON OAuth2 z Google

Integracja AIS Google Home wymaga konfiguracji projektu w Google oraz rejestracji naszego urządzenia - aby Asystent Google reagował na polecenia odpowiednie dla naszego urządzenia.

Poniżej pokażemy przykładowo jak wykonać rejestracje urządzenia w Google krok po kroku.

uwaga

Integracja po stronie Google

API do Asystenta Google jest intensywnie rozwijane przez Google, dlatego proces integracji po stronie Google może się zmieniać. Jeżeli opis poniżej nie jest aktualny to należy postępować zgodnie z najnowszym opisem/przewodnikiem Google dostępnym na stronie Integrate with the Google Assistant.

1. Zaloguj się do platformy umożliwiającej rozszerzenie funkcjonalności Asystenta Google https://console.actions.google.com/

2. Utwórz nowy projekt

aby kontynuować należy zatwierdzić warunki serwisu

3. Podaj nazwę, zmień jezyk projektu na Polski oraz lokalizację na Polska. Następnie naciśnij Create project

4. Wybierz opcję Device registration

5. Naciśnij REGISTER MODEL

7. Podaj nazwę produktu, producenta oraz wybierz typ urządzenia Speaker

8. Pobierz plik oAuth2.0 i zapisz go na swoim dysku (będzie nam potrzebny w kolejnym kroku)

9. Zaznacz wszystkie cechy (All traits) i zapisz konfigurację

Włączenia API dla Asystenta Google

Kolejnym krokiem, który należy zrobić po stronie Google, jest włączenie API dla Asystenta. W tym celu należy:

1. Przejść w nowej karcie przeglądarki do Google API

aby kontynuować należy zatwierdzić warunki serwisu

2. Włączyć Google Assistant API dla naszego projektu

Wybierzmy (upewnijmy się, że mamy wybrany) nasz projekt AI-Speaker

wyszukajmy i włączmy Google Assistant API dla projektu

3. Przejść do Dane logowania i wybrać SKONFIGURUJ EKRAN AKCEPTACJI

4. Wypełnić pole Nazwa aplikacji oraz wybrać Adres e-mail pomocy następnie nacisnąć przycisk Zapisz na dole

Poświadczenie oAuth2 dla urządzenia

Wracamy do naszego ekranu integracji w Asystencie domowym i w pole Poświadczenie oAuth2 dla urządzenia wklejamy całą zawartość pliku JSON OAuth2 pobranego z Google

następnie naciskamy SUBMIT, by przejść do kolejnego ekranu

Klikamy na link uwierzytelniający

i logujemy się na konto w Google

Pozwalamy AI-Speaker na dostęp

Skopiuj kod

Wracamy do aplikacji Asystent domowy i wklejamy go w pole Kod

Otrzymamy nową integrację

Działanie Asystenta Google

Wywołanie Asystenta Google z Asystenta domowego

Żeby komenda była wysyłana bezpośrednio do Assystenta Google wystarczy ją poprzedzić słowem Google

Wywołanie Asystenta Google z API Asystenta domowego

AIS Google Home, podobnie jak inne integracje, udostępnia swoje usługi, dzięki czemu można automatyzować wysyłanie komendy do Asystenta Google z naszej bramki na podstawie statusu naszych urządzeń czy naszej obecności itp.

Rozwiązywanie Problemów

Uwaga

API do tworzenia urządzeń z Asystentem Google jest ciągle rozwijane. Programiści, którzy tworzą integrację z Google Home wiedzą, że nie wszytko jeszcze działa tak jak powinno. Sprawdź poniższe dodatkowe kroki, jeżeli coś nie działa.

Język w Google Home

Jednym z częstych problemów jest język, w jakim Google Asystent komunikuje się z nami. Żeby był to język polski, to w tej chwili trzeba jeszcze w aplikacji mobilnej Google Home ustawić dwa języki polski i angielski - tak jak to pokazano poniżej:

Informacja typu "Zaloguj się"

Jeżeli otrzymujesz informację typu "Zaloguj się na swoje konto", to upewnij się, że na koncie, które dodałeś do integracji z Google Assistant masz możliwość korzystania z Asystenta Google. W tym celu uruchom Google Assistant na tablecie lub telefonie, wybierz konto, które autoryzowałeś w integracji na bramce z Asystentem domowym i upewnij się, że działa z telefonu.

Dzieje się tak dlatego, że na niektórych kontach (np. firmowych lub dla edukacji) dodanych w Google administrator kont może decydować o włączeniu dostępu do Asystenta Google.

Jeżeli Asystent Google działa z innych urządzeń (na koncie, które podaliśmy przy integracji z Asystentem domowym), tak jak pokazano na rysunku poniżej:

to można przejść do wywoływania Asystenta Google z Asystenta domowego.

Brak odpowiedzi tekstowej

API Google Home nie zapewnia odpowiedzi tekstowej na wszystkie żądania. Asystent Google jest oparty na odpowiedziach audio (czyli do głośnika zwracane jest audio do odtworzenia), a nie tekst do przeczytania przez syntezator mowy (tak jak w przypadku Asystenta domowego).

Wiecej informacji w przykładowym projekcie Google SDK w Github