SpeechRecognitionResult

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die SpeechRecognitionResult-Schnittstelle der Web Speech API repräsentiert einen einzelnen Erkennungstreffer, der mehrere SpeechRecognitionAlternative-Objekte enthalten kann.

Instanz-Eigenschaften

SpeechRecognitionResult.isFinal Nur lesbar

Ein boolescher Wert, der angibt, ob dieses Ergebnis endgültig (true) oder nicht (false) ist — dies ist das letzte Mal, dass dieses Ergebnis zurückgegeben wird; wenn nicht, ist das Ergebnis vorläufig und kann später aktualisiert werden.

SpeechRecognitionResult.length Nur lesbar

Gibt die Länge des "Arrays" zurück — die Anzahl der im Ergebnis enthaltenen SpeechRecognitionAlternative-Objekte (auch als "n-best alternatives" bezeichnet).

Instanz-Methoden

SpeechRecognitionResult.item

Ein standardmäßiger Getter, der den Zugriff auf SpeechRecognitionAlternative-Objekte innerhalb des Ergebnisses über Array-Syntax ermöglicht.

Beispiele

Dieser Code ist aus unserem Speech color changer-Beispiel entnommen.

js
recognition.onresult = (event) => {
  // The SpeechRecognitionEvent results property returns a SpeechRecognitionResultList object
  // The SpeechRecognitionResultList object contains SpeechRecognitionResult objects.
  // It has a getter so it can be accessed like an array
  // The first [0] returns the SpeechRecognitionResult at position 0.
  // Each SpeechRecognitionResult object contains SpeechRecognitionAlternative objects
  // that contain individual results.
  // These also have getters so they can be accessed like arrays.
  // The second [0] returns the SpeechRecognitionAlternative at position 0.
  // We then return the transcript property of the SpeechRecognitionAlternative object
  const color = event.results[0][0].transcript;
  diagnostic.textContent = `Result received: ${color}.`;
  bg.style.backgroundColor = color;
};

Spezifikationen

Specification
Web Speech API
# speechreco-result

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch