Speech-Angular ist eine Angular Typescript-Bibliothek zur Integration von Sprachdiensten, wie Sprachausgabe (TTS), Spracherkennung (ASR), Sprachverstehen (NLU), Dialogverarbeitung (NLP) und Aktionsausführung in eine Angular Web-Seite oder Web-App. Kern von Speech-Angular ist ein BotService, der Dialoge eines Dialogskripts ausführen kann.
Daneben git es folgende einzeln verwendbare Dienste:
In Speech-Angular kann für die Sprachausgabe (TTS) und das Sprachverstehen (NLU) auch ein Clouddienst von Amazon, Google oder Microsoft verwendet werden. Dazu wird ein eigener Clouddienst Account des jeweiligen Clouddienst-Anbieters benötigt.
Die Speech-Angular Bibliothek benötigt das Speech-Framework, welches unter https://github.com/lingualogic/speech-framework in Github zu finden ist.
Um in eigenen Projekten Speech-Angular nutzen zu können, muss das Speech-Framework NPM-Package von der LinguaLogic-Seite heruntergeladen werden, in den eigenen Projektordner kopiert werden und vor Speech-Angular installiert sein. Das Speech-Framework NPM-Package wird mit folgendem Befehl installiert:
$ npm install speech-framework-0.5.20.tgzAlternativ kann das Speech-Framework auch über das offizielle globale NPM-Repository installiert werden:
$ npm install speech-frameworkWird speech-angular aus dem globalen NPM-Repository installert, wird speech-framework automatisch mitinstalliert.
Wir haben Speech-Angular auf Mac OS X 10.11, Mac OS X 10.13, Win 10 und Ubuntu 18.04 getestet. Als Plattformen können eingesetzt werden:
Es wird die aktuellste Angular-Version empfohlen
Grundsätzlich ist das Speech-Framework in Chrome, Firefox, Opera, Safari und Edge nutzbar, allerdings hängt die Sprachausgabe unter diesen Browsern von der zugrunde liegenden Text-to-Speech Engine der jeweiligen Plattformen ab. Die Spracheingabe funktioniert bisher nur in Chrome ohne die Nutzung von Nuance. Mit Nuance kann die Spracheingabe in allen hier aufgeführten Browsern verwendet werden.
NodeJS muss installiert sein.
Als weitere Plattformen können Android und iOS mit Cordova verwendet werden:
Für Cordova müssen weitere Programme zur Entwicklung von Android- und iOS-Apps installiert werden. Informationen hierzu finden sich unter docs/platform/Cordova.md.
Will man den Clouddienst verwenden, muss ein eigener Clouddienst Account eingerichtet werden und die Clouddienst-Komponente des Speech-Frameworks separat in die eigene App eingebunden werden. Wie man dies macht, findet man unter docs/cloud/Cloud.md
Die Installation kann vom globalen NPM-Repository aus erfolgen, oder als lokale Installation erzeugt man sich sein NPM-Package selbst.
Zur Installation von Speech-Angular ins eigene Projekt, im Projektverzeichnis folgenden Befehl eingeben:
$ npm install speech-angularInstalliert man speech-angular auf diese Art, wird speech-framework automatisch mitinstalliert.
Zuerst muss das Speech-Angular Github-Repsitory unter https://github.com/lingualogic/speech-angular mit folgendem Befehl geklont werden:
$ git clone https://github.com/lingualogic/speech-angular
$ cd speech-angulardanach werden alle NPM-Pakete für Speech-Angular mit folgendem Befehl installiert:
$ npm installanschließend kann man optional die Unit-Tests von Speech-Angular starten:
$ npm testzum Schluß wird das NPM-Paket für Speech-Angular im dist/ Ordner erzeugt:
$ npm run buildDie API-Dokumentation kann mit folgenden Befehl in docs/api erzeugt werden:
$ npm run docsDas im dist/ Ordner erzeugte npm-Paket 'speech-angular-0.5.20.tgz' kann in den eigenen Angular Projektordner kopiert werden.
Die Installation des speech-angular npm-Paketes erfolgt im eigenen Angular Projektordner mit folgendem Befehl:
$ npm install speech-angular-0.5.20.tgzDanach kann Speech-Angular im eigenen Angular-Projekt verwendet werden. Probiert es einfach mit einem unserer Schnelleinstiege aus.
Alternativ kann das fertige Speech-Angular npm-Paket auch von der LinguaLogic-Webseite heruntergeladen werden.
Speech-Angular kann mit folgendem Befehl wieder deinstalliert werden:
$ npm uninstall speech-angularIm examples Ordner sind mehrere kleine Beispiele für die einzelnen Services von Speech-Angular zu finden. Zum Ausführen der Beispiele darf nicht in den Beispielordner gewechselt werden. Von dort aus funktioniert der Start der jeweiligen Beispiel-App nicht, da globale NPM-Packages aus dem Projektverzeichnis benötigt werden.
Folgende Befehle sind für die SpeakService-Beispiele einzugeben:
$ npm run speakfür die TextToSpeech-Version oder
$ npm run speak-offlinefür die Audio-Version.
Für das ListenService-Beispiel ist folgender Befehl einzugeben:
$ npm run listenFür das IntentService-Beispiel ist folgender Befehl einzugeben:
$ npm run intentFür für das ActionService-Beispiel ist folgender Befehl einzugeben:
$ npm run actionDer BotService kann mit folgenden Befehlen gestartet werden:
$ npm run botfür die TextToSpeech-Version oder
$ npm run bot-offlinefür die Audio-Version.
Projektorganisation: Leo Füchsel (leo@lingualogic.de)
Technische Entwicklung: Stefan Brauer (stefan@lingualogic.de)
Wir haben das Entstehen und die Entwicklung des Projektes vielen Personen zu danken, vor allem dem gesamten Team der Nepos GmbH.
Speech-Angular wurde als Open Source unter der MIT-Lizenz veröffentlicht.