ioBroker Alexa-Integration

Mithilfe des ioBroker Alexa2-Adapters haben wir die Möglichkeit, dass ioBroker bestimmte Funktionen von Alexa steuern kann. Beispielsweise können wir die Sprachfähigkeit von Alexa nutzen, um Ankündigungen und Warnungen über die Lautsprecher Amazon Echo und Echo Dot Smart zu veröffentlichen.

Um den ioBroker Alexa2-Adapter nutzen zu können, benötigen wir ein ioBroker-Cloud-Service-Konto, das über den ioBroker.iot-Skill der Amazon Alexa-App mit Alexa verbunden werden kann.

Der Alexa2-Adapter kann mit einem der Online-Dienste „IoT Assistant“ oder „ioBroker Pro“ verwendet werden. Falls noch nicht geschehen, müssen wir eine Kopie des ioBroker at „ IoT“-Cloud-Adapters auf unserem lokalen Server installieren , um eine Verbindung zu den Online-Diensten herzustellen.

Installation des Alexa2-Adapters

Um den Alexa2-Adapter zu installieren, gehen wir auf die Seite „Adapter“ und geben wir den Suchbegriff „Alexa“ in das Suchfeld ein. Lassen wir uns eine Instanz des Alexa2-Adapters installieren.

Nach der Installation werden wir zur Seite mit den Adaptereinstellungen weitergeleitet. Um eine Verbindung zu Alexa-Geräten herzustellen, müssen wir den ioBroker Alexa2-Adapter mit unserem Amazon-Konto verbinden. Klicken wir dazu auf den Link.

Melden wir sich auf der sich öffnenden Seite mit unsere Amazon-Anmeldedaten an, wenn wir sich erfolgreich angemeldet haben, schließen wir die Seite. Die Einstellungen des Alexa2-Adapters sollten nun so aussehen.

Speichern und schließen wir die Einstellungsseite, indem wir auf die Schaltfläche „Speichern und schließen“ klicken. Damit ist die Installation des Alexa2-Adapters abgeschlossen.

Testen wir die Funktion des Alexa2-Adapters. Gehen wir zum Bedienfeld „Skripte“ und fügen wir eine neue Javascript-Datei hinzu. (Falls dieser noch nicht installiert ist, installieren Sie eine Kopie des Javascript-Adapters .)

Kopieren wir den folgenden Codeausschnitt in die leere Javascript-Datei.

var alexa = 'alexa2.0.Echo-Devices.xxxxxxxxx.Commands.speak'/*speak*/;
var text = 'Test Nachricht';

setState(alexa, text);

Wir ersetzen den Wert der Variablen „var alexa“ durch das Commands/speak-Objekt eines der Geräte im Unterordner „Echo-Devices“ des Alexa2-Adapters. Mit der Funktion setState() wird der Inhalt der Variablen „text“ an das angegebene Objekt übergeben.

Speichern wir die Datei, drücken wir die kleine Dreieckstaste, um das Skript zu starten, und hören wir dann Alexa.

Beispielsweise können wir Alexa mit dem VIS-Adapter auch über Taster steuern.

Alexa2-Adapter-objekte

Nach der Installation werden die Datenpunkte des Alexa2-Adapters auf der Registerkarte „Objekte“ erstellt.

Werfen wir einen Blick auf die Datenpunkte von Alexa2. Die erste Ebene des Verzeichnisbaums ist in der folgenden Tabelle zu sehen.

Echo-Devices	Dieser Ordner enthält die Amazon Echo-Geräte.
History	Die letzten Befehle und Ereignisse finden Sie im Verlaufsordner.
Smart-Home-Devices	Beinhaltet alle Smart-Home-Geräte, die Alexa kennt.
info	Hier finden Sie allgemeine Informationen zum Status des Adapters. Z.B. Ist der Adapter mit Alexa verbunden, aber auch hier finden wir Alexa-Cookies.
requestResult	Hinweise zu möglichen Fehlern finden wir in den Anfragen von TuneIn- und Smart-Home-Geräten.

Im Folgenden gehen wir ohne Anspruch auf Vollständigkeit auf die wichtigsten Datenpunkte des Ordners „ Echo-Devices “ ein.

Im Unterordner „ Commands“ finden wir das Objekt „ announcement“. Damit können wir mit Alexa eine Ankündigung auf dem jeweiligen Amazon Echo-Gerät veröffentlichen. Dieser Befehl ähnelt dem im obigen Beispiel angegebenen Befehl „ speak “. Alexa liest den als Parameter in der Textvariablen angegebenen String. Der Unterschied besteht darin, dass vor der Ausführung des Befehls „ announcement“ ein Warnton zu hören ist .

var alexa = 'alexa2.0.Echo-Devices.xxxx.Commands.announcement'/*announcement*/;
var text = 'Test Nachricht';

setState(alexa, text);

Das Objekt „ calendarNext “ erwartet als Parameter einen booleschen Wert. Wenn aktiviert, liest Alexa das nächste Ereignis in unserem Kalender vor.

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

setState(alexa, trigger);

Das Objekt „ calendarToday “ liest die Kalenderereignisse von heute, und „ calendarTomorrow“ liest die Kalenderereignisse von morgen mit Alexa, gemäß dem obigen Codeausschnitt.

„ doNotDisturb “ ist ebenfalls ein boolescher Wert, er aktiviert die Funktion Bitte nicht stören.

Wenn „ flashbriefing “ aktiviert ist, werden mit Alexa Nachrichten, lokales Wetter und mehr vorgelesen. Wir können die Nachrichtenanbieter in der Amazon Alexa-Anwendung Settings/News/MyNewsChannel  oder Settings/News/Flash Briefing festlegen.

Der Datenpunkt „speak“ wurde oben bereits vorgestellt. Mit dem „ speak-volume“-Objekt lässt sich die Lautstärke von Alexa anpassen. Als Parameter können wir eine Zahl zwischen 1 und 100 angeben.

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 Nachricht';

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

Mit Hilfe des „ textCommand “-Objekts können wir einen Textbefehl an Alexa senden. Sein Parameter ist String. Wir vermeiden die Verwendung von Zahlen im Text (Schreiben wir also zwei statt 2).

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

setState(alexa, command);

Das Objekt „ traffic“ liest die lokalen Verkehrsnachrichten, während das Objekt „ weather“ das Wetter mit Alexa liest. Beide Datenpunkte erwarten einen booleschen Wert.

Im Ordner „ Routines“ finden wir die in der Amazon Alexa-Anwendung erstellten Routinen. Wir können die Objekte aktivieren, indem wir sie auf true setzen.

Das war’s für den ioBroker Alexa2-Adapter. Weitere Informationen finden wir auf der Github- Seite des Adapters.