ioBroker Alexa integráció

Az ioBroker Alexa2 adapter segítségével lehetőségünk van arra, hogy az ioBroker irányíthassa az Alexa bizonyos funkcióit. Kihasználhatjuk például az Alexa beszédképességét, hogy bejelentéseket, figyelmeztetéseket tegyünk közzé az Amazon Echo, Echo Dot Smart hangszóróin keresztül.

Az ioBroker Alexa2 adapter használatához egy ioBroker felhőszolgáltatás fiókra van szükségünk, amelyet az Amazon Alexa alkalmazás ioBroker.iot készség segítségével kapcsolhatunk össze Alexával.

Az Alexa2 adapter „IoT Assistant” vagy az „ioBroker Pro” online szolgáltatások egyikével használható.  Ha még nincs, akkor telepítenünk kell a helyi ioBroker szerverünkre at „IoT” felhőadapter egy példányát, hogy csatlakozhassunk az online szolgáltatásokhoz.

Alexa2 adapter telepítése

Az Alexa2 adapter telepítéséhez lépjünk az Adapterek oldalra, és írjuk be a keresőbe az Alexa keresőszót. Telepítsünk egy példányt az Alexa2 adapterből.

Telepítés után az adapter beállítások oldalárara kerülünk. Az Alexa-eszközökhöz való csatlakozáshoz össze kell kapcsolunk az ioBroker Alexa2 adaptert az Amazon-fiókunkal. Ehez kattintsunk a linkre.

A megnyíló oldalon jelentkezzünk be az Amazon bejelentkezési adatainkal, ha sikeresen bejelentkeztünk, zárjuk be a lapot. Az Alexa2 adapter beállításainak most így kell kinéznie.

Mentsük el és zárjuk be a beállítások lapot a mentés és bezárás gombra kattintva. Ezzel az Alexa2 adapter telepítése befejeződott.

Teszteljük le az Alexa2 adapter működését. Lépjünk a Scripts panelra, adjunk hozzá egy új javascript fájlt. (Ha még nincs telepítve, akkor telepítsünk egy példányt a Javascript adapterből.)

Az üres javascript fájlba másoljuk be az alábbi kódrészletet.

var alexa = 'alexa2.0.Echo-Devices.xxxxxxxxx.Commands.speak'/*speak*/;
var text = 'tesztüzenet';

setState(alexa, text);

A „var alexa” változó értékét cseréljük le az Alexa2 adapter Echo-Devices almappában lévő eszközök valamelyikének a Commands/speak objektumára. A setState() függvény segítségével átadjuk a „text” változó tartalmát a megadott objektumnak.

Mentsük el a fájlt, nyomjuk meg a kis háromszög alakú gombot a script elindításához, majd halgassuk Alexát.

Például nyomógombokkal is irányíthatjuk Alexát a VIS adapter segítségével.

Alexa2 adapter objektumai

A telepítés után az Objektumok fülön létrejönnek az Alexa2 adapter adatpontjai.

Vegyük sora az Alexa2 adatpontjait. A könyvtárfa első szintjét láthatjuk a következő táblázatban.

Echo-Devices	Ebben a mappában vannak az Amazon Echo eszközök.
History	A History mappában találjuk az utolsó parancsokat, eseményeket.
Smart-Home-Devices	Tartalmazza az összes Smart-home eszközt, amelyeket Alexa ismer.
info	Itt általános információkat találunk az adapter állapotáról. Pl. Az adapter kapcsolódik-e Alexához, de itt találjuk az Alexa cookie-kat is.
requestResult	A TuneIn és a Smart-home eszközök kéréseinek az esetleges hibáiról találunk információt.

Továbbiakban megvizsgáljuk az „Echo-Devices” mappa fontosabb adatpontjait, a teljesség igénye nélkül.

A „Commands„ almappában találjuk az „announcement” objektumot. Ezzel közleményt tehetünk közzé az adott Amazon Echo készüléken Alexával. Ez a parancs hasonló a fenti példában megadott „speak” parancshoz, Alexa beolvassa a text változóban paraméterként megadott Stringet. A különbség, hogy a „announcement” parancs végrehajtása elött figyelmeztető hangjelzés hallható.

var alexa = 'alexa2.0.Echo-Devices.xxxx.Commands.announcement'/*announcement*/;
var text = 'tesztüzenet';

setState(alexa, text);

A „calendarNext„objektum egy bolean értéket vár paraméterként. Ha aktiváljuk, Alexa beolvassa a naptárunkban szerepló következő eseményt.

var alexa = 'alexa2.0.Echo-Devices.xxxx.Commands.calendarNext'/*calendarNext*/;
var trigger = true;

setState(alexa, trigger);

A „calendarToday” objektum a mai napi, a „calendarTomorrow” a holnapi naptáreseményeket olvastatja fel Alexával a fenti kódrészlet szerint.

A „doNotDisturb” szintén bolean érték, a ne zavarj funkciót aktiválja.

A „flashbriefing” aktiválásakor híreket, helyi időjárást és egyebeket olvastat be Alexával. Az Amazon Alexa alkalmazás Settings/News/MyNewsChannel vagy Settings/News/Flash Briefing menüpontokban beállíthatjuk a hírszolgáltatókat.

A „speak” adatpont már feljebb bemutatásra került. A „speak-volume” ojektum segítségével beállíthatjuk Alexa hangerejét. Paraméterként számot adhatunk, 1-100-ig.

var alexa_speak = 'alexa2.0.Echo-Devices.xxxx.Commands.speak'/*speak*/;
var alexa_volume = 'alexa2.0.Echo-Devices.xxxx.Commands.speak-volume'/*Volume to use for speak commands*/
var num = 80;
var text = 'test';

setState(alexa_volume, num);
setState(alexa_speak, text);

A „textCommand” objektum segítségével szöveges parancsot küldhetünk Alexának. A paramétere String. A szövegben kerüljük a számok használatát (tehét a 2 helyett írjunk kettőt).

var alexa = 'alexa2.0.Echo-Devices.xxxx.Commands.textCommand'/*textCommand*/;
var command = 'Wohnzimmerlicht einschalten!';

setState(alexa, command);

A „traffic” objektum a helyi közlekedési híreket, míg a „weather” az időjárást olvastatja be Alexával. Mindkét adatpont bolean értéket vár.

A „Routines” mappában találjuk az Amazon Alexa alkalmazásban létrehozott rutinokat. Az objektumok true-ra állításával aktiválhatjuk őket.

Egyenlőre ennyi az ioBroker Alexa2 adapteréről. További infó az adapter github oldalán található.