SpeechGrammarList: addFromString() Methode

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 vor der Verwendung auf produktiven Webseiten.

Die addFromString()-Methode des SpeechGrammarList Interfaces nimmt eine Grammatik, die in einem bestimmten String innerhalb des Codebases vorhanden ist (z.B. in einer Variablen gespeichert), und fügt sie der SpeechGrammarList als neues SpeechGrammar-Objekt hinzu.

Syntax

js
addFromString(string)
addFromString(string, weight)

Parameter

string

Ein String, der die hinzuzufügende Grammatik darstellt.

weight Optional

Ein Float, der das Gewicht der Grammatik relativ zu anderen Grammatiken in der SpeechGrammarList repräsentiert. Das Gewicht gibt die Bedeutung dieser Grammatik an oder die Wahrscheinlichkeit, dass sie vom Spracherkennungsdienst erkannt wird. Der Wert kann zwischen 0.0 und 1.0 liegen; falls nicht angegeben, wird der Standardwert 1.0 verwendet.

Rückgabewert

Keiner (undefined).

Beispiele

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
# dom-speechgrammarlist-addfromstring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch