Speech (WebWidget)
Das Speech-WebWidget bietet die Möglichkeit zur Spracheingabe und -ausgabe. |
Verwendung
Abhängigkeiten
- speech.html
- speech-directive.js
Nachrichtenschnittstelle
Bei der Richtungsbeschreibung wird das WebWidget in seine zwei Komponenten unterteilt. Das in HTML implementierte WebWidget, welches die Darstellungslogik und Nutzerinteraktion im Browser implementiert und das in InstantView implementierte WebWidget, welches die andere Seite mit den Daten aus ClassiX versorgt und es steuert.
Name | Parameter | Beschreibung |
---|---|---|
Push-Nachrichten (IV→HTML) | ||
speak | Utterance | Diese Nachricht übergibt ein Utterance-Objekt als CX_JSON_OBJECT ans WebWidget und legt den Text fest, der gesprochen werden soll. |
listen | Parameter | Diese Nachricht übergibt Parameter als CX_JSON_OBJECT ans WebWidget und startet die Spracheingabe. |
stop_listening | - | Diese Nachricht weist das WebWidget an, die Spracheingabe zu stoppen. |
Ereignisse (HTML→IV) | ||
TRANSCRIPT_SOCKET | Result | Diese Nachricht wird ausgelöst, wenn die Spracheingabe ein Ergebnis hat. Dieses kann ein Zwischenergebnis sein. |
Das Utterance-Objekt
Feld | Typ | Standardwert | Beschreibung |
---|---|---|---|
text | String | - |
Dies ist der Text, der gesprochen werden soll. Als einziger Wert nicht optional. |
pitch | Float | 1.0 |
Muss im Bereich 0.0 - 2.0 liegen. Verändert die Höhe der Stimme. Optional. |
volume | Float | 1.0 |
Muss im Bereich 0.0 - 1.0 liegen. Verändert die Lautstärke der Stimme. Optional. |
rate | Float | 1.0 |
Muss im Bereich 0.1 - 10.0 liegen. Verändert die Geschwindigkeit der Stimme. Optional. |
lang | Float | "de" | Ein String, der die Sprache festlegt (im BCP47 Format, z.B. "en-GB"). Optional. |
Das Parameter-Objekt
Feld | Typ | Standardwert | Beschreibung |
---|---|---|---|
continuous | Boolean | FALSE |
Legt fest, ob die Spracheingabe nach einer Eingabe beendet werden soll. Wenn TRUE, dann wird solange zugehört, bis stop_listening gesendet wird. |
interimResults | Boolean | FALSE |
Legt fest, ob Zwischenergebnisse gesendet werden sollen. Wenn FALSE, wird nur ein Ergebnis gesendet, wenn der Benutzer aufhört, zu sprechen. Wenn TRUE, werden auch vorher schon Bruchstückhafte Ergebnisse gesendet. |
maxAlternatives | Integer | 1 |
Wieviele Alternativen gesendet werden sollen. Das Ergebnis ist eine Liste von Alternativen, sortiert nach absteigender Wahrscheinlichkeit. Beispiel: "Ein Wal", "Einwahl", "Ein Wahl", "Einen Wal", etc. |
Das Result-Objekt
Feld | Typ | Beschreibung |
---|---|---|
isFinal | Boolean |
TRUE, wenn der Benutzer aufgehört hat zu sprechen, FALSE wenn er noch nicht fertig ist. Wenn interimResult FALSE ist, wird isFinal immer TRUE sein. |
length | Integer | Die Anzahl an Alternativen, höchstens maxAlternatives. |
0 ... length-1 | Alternative | Das Result-Objekt ist ein Array von Alternativen, sortiert nach absteigender Wahrscheinlichkeit. |
Das Alternative-Objekt
Feld | Typ | Beschreibung |
---|---|---|
confidence | Float |
Die Wahrscheinlichkeit, dass der Benutzer tatsächlich diesen Text gesagt hat. 0.0 - 1.0 |
transcript | String | Der Text, den der Benutzer gesagt hat. |