SpeechRecognition
Eingeschränkt verfügbar
*
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Die SpeechRecognition-Schnittstelle der Web Speech API ist die Steuerungsschnittstelle für den Spracherkennungsdienst. Sie verarbeitet auch die vom Spracherkennungsdienst gesendeten SpeechRecognitionEvent-Ereignisse.
Hinweis:
In einigen Browsern verwendet die Spracherkennung standardmäßig eine serverbasierte Erkennungs-Engine.
Ihre Audiodaten werden zur Verarbeitung an einen Webdienst gesendet. Daher funktioniert die Spracherkennung ohne Internetverbindung nur, wenn Sie mit processLocally die Spracherkennung auf dem Gerät vorschreiben.
Konstruktor
SpeechRecognition()-
Erstellt ein neues
SpeechRecognition-Objekt.
Instanzeigenschaften
SpeechRecognition erbt außerdem Eigenschaften von seiner übergeordneten Schnittstelle EventTarget.
SpeechRecognition.lang-
Gibt die Sprache der aktuellen
SpeechRecognitionzurück und legt sie fest. Wenn kein Wert angegeben ist, wird standardmäßig der Wert des HTML-Attributslangverwendet. Ist auch dieses nicht festgelegt, wird die Spracheinstellung des User-Agents verwendet. SpeechRecognition.continuous-
Steuert, ob bei der Spracherkennung fortlaufend Ergebnisse oder nur ein einzelnes Ergebnis zurückgegeben werden. Standardmäßig wird nur ein einzelnes Ergebnis zurückgegeben (
false). SpeechRecognition.interimResults-
Steuert, ob Zwischenergebnisse zurückgegeben werden sollen (
true) oder nicht (false). Zwischenergebnisse sind noch nicht endgültig (d.h. die EigenschaftSpeechRecognitionResult.isFinalistfalse). SpeechRecognition.maxAlternatives-
Legt die maximale Anzahl von
SpeechRecognitionAlternative-Objekten fest, die pro Ergebnis bereitgestellt werden. Der Standardwert ist 1. SpeechRecognition.phrases-
Legt ein Array von
SpeechRecognitionPhrase-Objekten fest, die für die kontextabhängige Gewichtung verwendet werden. SpeechRecognition.processLocally-
Gibt an, ob die Spracherkennung lokal auf dem Gerät des Benutzers durchgeführt werden muss.
SpeechRecognition.unspokenPunctuation-
Gibt an, ob die Spracherkennungs-Engine anhand der natürlichen Sprechweise des Benutzers Satzzeichen erschließt und einfügt.
Veraltete Eigenschaften
Das Konzept der Grammatik wurde aus der Web Speech API entfernt. Zugehörige Funktionen sind aus Gründen der Abwärtskompatibilität weiterhin in der Spezifikation enthalten und werden von unterstützenden Browsern noch erkannt, haben aber keine Auswirkungen auf Spracherkennungsdienste.
SpeechRecognition.grammars-
Repräsentiert eine Sammlung von
SpeechGrammar-Objekten.
Statische Methoden
SpeechRecognition.available()-
Prüft, ob die angegebenen Sprachen für die Spracherkennung verfügbar sind.
SpeechRecognition.install()-
Installiert die benötigten Sprachpakete für die Spracherkennung auf dem Gerät in den angegebenen Sprachen.
Instanzmethoden
SpeechRecognition erbt außerdem Methoden von seiner übergeordneten Schnittstelle EventTarget.
SpeechRecognition.abort()-
Beendet die Erfassung eingehender Audiodaten durch den Spracherkennungsdienst, ohne zu versuchen, ein
SpeechRecognitionResultzurückzugeben. SpeechRecognition.start()-
Startet die Erfassung eingehender Audiodaten durch den Spracherkennungsdienst (von einem Mikrofon oder einem Audiotrack). Ergebnisse werden über das
result-Ereignis bereitgestellt. SpeechRecognition.stop()-
Beendet die Erfassung eingehender Audiodaten durch den Spracherkennungsdienst und versucht, auf Grundlage der bisher erfassten Audiodaten ein Ergebnis zurückzugeben.
Ereignisse
Überwachen Sie diese Ereignisse mit addEventListener() oder indem Sie der oneventname-Eigenschaft dieser Schnittstelle einen Event-Listener zuweisen.
audiostart-
Wird ausgelöst, wenn der User-Agent mit der Erfassung von Audiodaten begonnen hat.
audioend-
Wird ausgelöst, wenn der User-Agent die Erfassung von Audiodaten abgeschlossen hat.
end-
Wird ausgelöst, wenn der Spracherkennungsdienst die Verbindung getrennt hat.
error-
Wird ausgelöst, wenn bei der Spracherkennung ein Fehler auftritt.
nomatch-
Wird ausgelöst, wenn der Spracherkennungsdienst ein endgültiges Ergebnis zurückgibt, ohne dass eine ausreichend zuverlässige Erkennung stattgefunden hat. Dabei kann ein gewisser Grad an Erkennung vorliegen, der jedoch den
confidence-Schwellenwert nicht erreicht oder überschreitet. result-
Wird ausgelöst, wenn der Spracherkennungsdienst ein Ergebnis zurückgibt. Dieses kann endgültig oder vorläufig sein (wenn
interimResultstrueist). soundstart-
Wird ausgelöst, wenn ein Geräusch erkannt wurde – unabhängig davon, ob es sich um erkennbare Sprache handelt.
soundend-
Wird ausgelöst, wenn kein Geräusch mehr erkannt wird – unabhängig davon, ob es sich um erkennbare Sprache handelt.
speechstart-
Wird ausgelöst, wenn ein Geräusch erkannt wurde, das der Spracherkennungsdienst als Sprache einstuft.
speechend-
Wird ausgelöst, wenn keine Sprache mehr erkannt wird, die der Spracherkennungsdienst als solche einstuft.
start-
Wird ausgelöst, wenn der Spracherkennungsdienst beginnt, auf zu erkennende Audiodaten zu warten.
Beispiele
In unserem Beispiel Sprachgesteuerter Farbwechsler erstellen wir mit dem Konstruktor SpeechRecognition() eine neue Instanz eines SpeechRecognition-Objekts.
Nachdem wir einige weitere Werte definiert haben, richten wir die Anwendung so ein, dass der Spracherkennungsdienst beim Klicken auf eine Schaltfläche startet (siehe SpeechRecognition.start()). Wenn eine Äußerung erfolgreich erkannt wurde, wird das result-Ereignis ausgelöst. Wir lesen die ausgesprochene Farbe aus dem Ereignisobjekt aus und setzen anschließend die Hintergrundfarbe des <html>-Elements auf diese Farbe.
const recognition = new SpeechRecognition();
recognition.continuous = false;
recognition.lang = "en-US";
recognition.interimResults = false;
recognition.maxAlternatives = 1;
const diagnostic = document.querySelector(".output");
const bg = document.querySelector("html");
const startBtn = document.querySelector("button");
startBtn.onclick = () => {
recognition.start();
console.log("Ready to receive a color command.");
};
recognition.onresult = (event) => {
const color = event.results[0][0].transcript;
diagnostic.textContent = `Result received: ${color}`;
bg.style.backgroundColor = color;
};
Spezifikationen
| Spezifikation |
|---|
| Web Speech API> # speechreco-section> |