Lade...
 

Speech

Speech (WebWidget)

Das Speech-WebWidget bietet die Möglichkeit zur Spracheingabe und -ausgabe.

Verwendung

Web(speech, "speech.html", 0, 0, 800, 600)

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.