Integrace RichPear Home

Google Assistant SDK

Google Assistant SDK patří do kategorií oznámení, hlas. Následující postup shrnuje základní nastavení a kontrolu v RichPear Home.

Začít nastavení Zpět na integrace

Doména: google_assistant_sdk
Kategorie: oznámení, hlas
Komunikace: cloud-polling
Kvalita: gold

Připravte přístup a síť

Před přidáním integrace si připravte účet, IP adresu, token, párovací režim nebo API klíč podle typu zařízení. U lokálních zařízení ověřte, že jsou ve stejné síti jako RichPear Home.

U této integrace počítejte hlavně s: lokální komunikaci nebo lokální zjišťování zařízení, cloudový účet, token nebo API přístup, třídu komunikace cloud-polling.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

Přidejte integraci v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Google Assistant SDK a projděte průvodce nastavením.

Dokumentace integrace podporuje přidání přes integrační průvodce. V RichPear Home proto začněte vyhledáním integrace v nastavení.

Pokud integrace vyžaduje cloudový účet, používejte samostatný servisní účet, kde to dává smysl. U zařízení v domácí síti nejdřív ověřte pevnou IP adresu nebo spolehlivé mDNS jméno.

Zkontrolujte entity, funkce a akce

Po dokončení nastavení otevřete detail integrace, zkontrolujte vytvořená zařízení a entity a přiřaďte je do správných oblastí.

Dokumentace integrace zmiňuje i tyto akce nebo služby: Akce: Broadcast message.

Projekt a OAuth

Google Assistant SDK vyžaduje Google Cloud projekt, povolené API a OAuth přihlašovací údaje. Při nastavení si připravte client ID, client secret a autorizaci účtu.

Integrace se používá pro odesílání příkazů nebo dotazů do Google Assistant, ne jako obecné lokální hlasové rozhraní.

Použití a limity

Příkazy posílejte cíleně a s rozumnou frekvencí. Cloudová služba může mít limity a zpoždění.

Pro oznámení nebo běžné hlasové reakce ověřte, zda není vhodnější lokální TTS nebo jiná notifikační integrace.

Provozní kontrola

U příkazů přes SDK logujte, co bylo odesláno a jaká přišla odpověď. Bez toho se špatně rozlišuje chyba v textu příkazu, autorizaci nebo dostupnosti cloudové služby.

Kontrola po změně

Příkazy přes SDK držte krátké a jednoznačné. Pokud stejný text může Google vyhodnotit více způsoby, vytvořte raději samostatnou scénu v RichPear Home a přes SDK spouštějte jen ověřený příkaz.