GrammarBuilder Classe

Definizione

public ref class GrammarBuilder

public class GrammarBuilder

type GrammarBuilder = class

Public Class GrammarBuilder

Ereditarietà

Object

GrammarBuilder

Esempio

Nell'esempio seguente vengono GrammarBuilder utilizzati Choices gli oggetti e per costruire una grammatica in grado di riconoscere una delle due frasi "make background colorChoice" o "set background to colorChoice".

Nell'esempio viene utilizzato un Choices oggetto per creare un elenco di valori accettabili per colorChoice da una matrice di String oggetti. Un Choices oggetto è analogo all' one-of elemento nella specifica SRGS e contiene un set di frasi alternative, ciascuna delle quali può essere riconosciuta quando viene pronunciata. Nell'esempio viene inoltre utilizzato un Choices oggetto per raggruppare una matrice di due GrammarBuilder oggetti in una coppia di frasi alternative che la grammatica risultante può riconoscere. Parole o frasi alternative sono un componente della maggior parte delle grammatiche e l' Choices oggetto fornisce questa funzionalità per le grammatiche costruite con GrammarBuilder .

Viene infine creato un Grammar oggetto da un GrammarBuilder oggetto costruito da un Choices oggetto.

private Grammar CreateColorGrammar()  
{  

  // Create a set of color choices.  
  Choices colorChoice = new Choices(new string[] {"red", "green", "blue"});  
  GrammarBuilder colorElement = new GrammarBuilder(colorChoice);  

  // Create grammar builders for the two versions of the phrase.  
  GrammarBuilder makePhrase = new GrammarBuilder("Make background");  
  makePhrase.Append(colorElement);  
  GrammarBuilder setPhrase = new GrammarBuilder("Set background to");  
  setPhrase.Append(colorElement);  

  // Create a Choices for the two alternative phrases, convert the Choices  
  // to a GrammarBuilder, and construct the grammar from the result.  
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});  
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);  
  grammar.Name = "backgroundColor";  
  return grammar;  
}  

Commenti

Le grammatiche di riconoscimento vocale vengono in genere create nel formato XML definito dalla specifica SRGS (Speech Recognition Grammar) versione 1,0. Se si ha familiarità con SRGS, ma si vogliono generare le grammatiche a livello di codice, è possibile usare lo System.Speech.Recognition.SrgsGrammar spazio dei nomi, i cui membri corrispondono strettamente agli elementi e agli attributi definiti da SRGS. Se non si ha familiarità con SRGS o si vuole un approccio leggero e programmatico per la creazione di grammatiche con cui è possibile eseguire in modo efficiente molti scenari comuni; è possibile usare le GrammarBuilder Choices classi e.

Usare GrammarBuilder gli oggetti per compilare un albero gerarchico composto da Choices oggetti contenenti frasi alternative, sparpagliate con il preambolo e le frasi post-ambite in ogni nodo e con il seeding con valori semantici che riportano il significato all'applicazione.

Per usare un GrammarBuilder oggetto per creare un Grammar oggetto, seguire questa procedura.

1. Creare un oggetto GrammarBuilder.

2. Aggiungere vincoli a GrammarBuilder , ad esempio oggetti,,,, String Choices SemanticResultKey SemanticResultValue DictationGrammar e altri GrammarBuilder oggetti che definiscono i vincoli per la grammatica.

3. Usare uno dei Grammar costruttori per creare un Grammar oggetto dalla GrammarBuilder grammatica completata.

La creazione di con GrammarBuilder è più adatta alle grammatiche con una singola regola contenente elenchi o elenchi di elenchi. Per compilare a livello di codice grammatiche con più regole o che devono eseguire riferimenti a regole interne, usare le classi dello System.Speech.Recognition.SrgsGrammar spazio dei nomi.

Le istanze di GrammarBuilder possono anche essere ottenute tramite conversioni implicite da determinate altre classi o combinando un GrammarBuilder oggetto con un secondo oggetto che contiene vincoli per una grammatica. Per ulteriori informazioni, vedere gli Implicit Addition operatori e e i Add metodi.

Per aggiungere regole a un oggetto esistente GrammarBuilder , usare i Add metodi,, Append AppendDictation , AppendRuleReference e AppendWildcard .

Per semplificare il debug, la DebugShowPhrases proprietà restituisce lo stato corrente dell'oggetto GrammarBuilder sotto forma di stringa.

Costruttori

Proprietà

Metodi

Operatori

Si applica a

Vedi anche

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue