Integrace RichPear Home

Alexa Devices

Alexa Devices připojí k RichPear Home zařízení s podporou Alexa, která jsou navázaná na váš Amazon účet. Integrace umí číst informace ze zařízení a ovládat hlavní podporované funkce.

Doména
alexa_devices
Nastavení
Přes Nastavení
Komunikace
cloud, dotazování
Aktualizace
výchozí dotazování po 5 minutách
01

Připravte Amazon účet a 2FA aplikaci

Integrace vyžaduje Amazon účet, ke kterému jsou připojená Alexa zařízení. Pro přihlášení je povinné vícefaktorové ověření přes autentizační aplikaci, například Microsoft Authenticator. SMS kódy nejsou pro tento integrační postup vhodné.

V Amazon účtu nastavte ověřovací aplikaci jako preferovanou metodu dvoufázového ověření. Před nastavením si ověřte, že se stejnými údaji projdete přihlášením do lokálního Amazon webu a že dostanete OTP kód z aplikace.

Podporované rodiny zařízení

Podporované jsou Amazon Echo Auto, Echo Dot, Echo Flex, Echo Plus, Echo Show, Fire TV Stick, Fire Tablet, Amazon Air Quality Monitor a zařízení třetích stran s vestavěnou podporou Alexa.

02

Přidejte Alexa Devices v RichPear Home

Otevřete RichPear Home na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

V bočním menu přejděte do Nastavení → Zařízení a služby, zvolte Přidat integraci, vyhledejte Alexa Devices a postupujte podle průvodce.

Průvodce vyžaduje e-mail Amazon účtu, heslo Amazon účtu a jednorázový OTP kód z autentizační aplikace. Po úspěšném přihlášení se integrace uloží pod daným Amazon účtem.

Stránka integrace před přidáním Amazon účtu.
Formulář požaduje e-mail, heslo a OTP kód z ověřovací aplikace.
Používejte účet, který odpovídá Alexa aplikaci a Amazon nákupnímu webu ve vaší zemi. Amazon Japan používá odlišný přihlašovací mechanismus a nastavení integrace tam může selhat.
03

Zkontrolujte vytvořené entity

Ne každé Alexa zařízení podporuje všechny entity. V detailu integrace proto zkontrolujte konkrétní zařízení, vzniklé entity a přiřazení do oblastí.

Integrace může vytvářet časové senzory pro další alarm, časovač a připomínku včetně jejich popisků. Podle schopností zařízení se mohou objevit také senzory teploty, osvětlení, Wi-Fi a Bluetooth konektivity.

Další funkce

Podporované entity zahrnují tlačítka pro spuštění Alexa rutin, notifikační entity pro Speak a Announce a přepínač režimu Nerušit. Amazon Air Quality Monitor může poskytovat částice PM10 a PM2.5, oxid uhelnatý, index těkavých organických látek a index kvality vzduchu.

04

Používejte podporované akce

Pro oznámení na zařízení s vytvořenými notifikačními entitami použijte akci notify.send_message s parametrem message. Při posílání na více zařízení může Amazon omezovat rychlost; spolehlivější bývá posílat oznámení na skupiny reproduktorů vytvořené v Alexa.

Integrace přidává také akce alexa_devices.send_text_command, alexa_devices.send_sound a alexa_devices.send_info_skill. Všechny vyžadují device_id; textový příkaz navíc text_command, zvuk sound a informační dovednost info_skill.

Zvuková akce nabízí předdefinované zvuky, například zvonek, potlesk nebo systémové upozornění. Informační dovednosti zahrnují datum, čas, počasí, dopravní informace, zprávy, vtip, příběh, ranní pozdrav a večerní rozloučení.

Textové příkazy se chovají jako příkazy zadané Alexe hlasem. Než je zapojíte do automatizací, otestujte je ručně na jednom zařízení.
05

Počítejte s limity Amazonu

Integrace ve výchozím stavu dotazuje data každých pět minut. Pokud v logu uvidíte chyby typu Too many requests, jde o omezení ze strany Amazonu. Vypnutí dotazování zastaví aktualizaci režimu Nerušit, senzorů a konektivity, ale řečové výstupy, oznámení a textové příkazy zůstávají dostupné.

Připomínky se nemusí přidat do senzoru, pokud je nastavený účet propojený s Alexa Household.

Pokročilá oznámení

Notifikační zprávy mohou používat hlasový markup podporovaný Alexou. Externí audio soubory musí být dostupné přes HTTPS a splňovat limity Amazonu pro velikost, bitrate a vzorkovací frekvenci; tento způsob je vhodný pro krátké efekty, ne pro přehrávání hudby.

06

Řešte přihlášení a nedostupné senzory

Při chybách přihlášení CannotAuthenticate, MFA OTP code not found on login page nebo Cannot find "auth-mfa-otpcode" in html source zkontrolujte správný e-mail, heslo a ověřovací aplikaci. Účet nesmí čekat na SMS kód; jednorázový kód musí pocházet z aplikace OTP.

Pokud jsou senzory nedostupné a v logu se objevují chyby Too many requests, CannotRetrieveData nebo hlášení o neaktualizovaných časovačích a alarmech, jde typicky o omezení požadavků na straně Amazonu. Pomůže snížit práci se senzory nebo vypnout dotazování u této integrace.

Odebrání integrace

Odebrání používá standardní postup: v Nastavení → Zařízení a služby otevřete kartu integrace, vyberete instanci a v menu se třemi tečkami zvolíte odstranění.