Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

EventTarget SpeechRecognition

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 SpeechRecognition zurück und legt sie fest. Wenn kein Wert angegeben ist, wird standardmäßig der Wert des HTML-Attributs lang verwendet. 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 Eigenschaft SpeechRecognitionResult.isFinal ist false).

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 SpeechRecognitionResult zurü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 interimResults true ist).

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.

js
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

Browser-Kompatibilität

Siehe auch