SpeechGrammarList

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Das SpeechGrammarList-Interface der Web Speech API repräsentiert eine Liste von SpeechGrammar-Objekten, die Wörter oder Muster von Wörtern enthalten, die der Erkennungsdienst erkennen soll.

Grammatik wird unter Verwendung des JSpeech Grammar Format (JSGF) definiert. In Zukunft könnten auch andere Formate unterstützt werden.

Konstruktor

SpeechGrammarList()

Erstellt ein neues SpeechGrammarList-Objekt.

Instanz-Eigenschaften

SpeechGrammarList.length Nur lesbar

Gibt die Anzahl der SpeechGrammar-Objekte zurück, die in der SpeechGrammarList enthalten sind.

Instanz-Methoden

SpeechGrammarList.item()

Standard-Getter — ermöglicht das Abrufen einzelner SpeechGrammar-Objekte von der SpeechGrammarList mithilfe von Array-Syntax.

SpeechGrammarList.addFromURI()

Nimmt eine Grammatik, die an einer bestimmten URI vorhanden ist, und fügt sie der SpeechGrammarList als neues SpeechGrammar-Objekt hinzu.

SpeechGrammarList.addFromString()

Fügt eine Grammatik in einem String der SpeechGrammarList als neues SpeechGrammar-Objekt hinzu.

Beispiele

In unserem einfachen Beispiel zur Sprachfarbänderung erstellen wir eine neue SpeechRecognition-Objektinstanz mit dem SpeechRecognition()-Konstruktor, erstellen eine neue SpeechGrammarList, fügen unsere Grammatikzeichenfolge mit der Methode SpeechGrammarList.addFromString hinzu und setzen sie als die Grammatik, die von der SpeechRecognition-Instanz erkannt wird, mit der SpeechRecognition.grammars-Eigenschaft.

js
const grammar =
  "#JSGF V1.0; grammar colors; public <color> = aqua | azure | beige | bisque | black | blue | brown | chocolate | coral | crimson | cyan | fuchsia | ghostwhite | gold | goldenrod | gray | green | indigo | ivory | khaki | lavender | lime | linen | magenta | maroon | moccasin | navy | olive | orange | orchid | peru | pink | plum | purple | red | salmon | sienna | silver | snow | tan | teal | thistle | tomato | turquoise | violet | white | yellow ;";
const recognition = new SpeechRecognition();
const speechRecognitionList = new SpeechGrammarList();
speechRecognitionList.addFromString(grammar, 1);
recognition.grammars = speechRecognitionList;

Spezifikationen

Specification
Web Speech API
# speechgrammarlist

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch