GrammarBuilder Konstruktorer

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder();

public GrammarBuilder();

Public Sub New ()

Exempel

I följande exempel används GrammarBuilder och Choices objekt för att konstruera en grammatik som kan känna igen någon av de två fraserna, "Make background colorChoice" eller "Set background to colorChoice".

I exemplet används ett Choices objekt för att skapa en lista med acceptabla värden för colorChoice från en matris med String objekt. Ett Choices objekt motsvarar elementet one-of i SRGS-specifikationen och innehåller en uppsättning alternativa fraser, av vilka någon kan identifieras när det talas. I exemplet används också ett Choices objekt för att gruppera en matris med två GrammarBuilder objekt i ett par alternativa fraser som den resulterande grammatiken kan känna igen. Alternativa ord eller fraser är en komponent i de flesta grammatiker, och objektet tillhandahåller den Choices här funktionen för grammatik som konstruerats med GrammarBuilder.

Exemplet skapar slutligen ett Grammar objekt från ett GrammarBuilder konstruerat objekt Choices .

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 object from the result.
  GrammarBuilder bothPhrases = new GrammarBuilder();
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  bothPhrases.Append(bothChoices);
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Kommentarer

Om du vill lägga till regler i ett befintligt GrammarBuilder objekt använder du Addmetoderna , Append, AppendDictation, AppendRuleReferenceoch och AppendWildcard operatorn Addition .

Se även

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::Choices ^ alternateChoices);

public GrammarBuilder(System.Speech.Recognition.Choices alternateChoices);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.Choices -> System.Speech.Recognition.GrammarBuilder

Public Sub New (alternateChoices As Choices)

Parametrar

Exempel

I följande exempel används GrammarBuilder och Choices objekt för att konstruera en grammatik som kan känna igen någon av de två fraserna, "Make background colorChoice" eller "Set background to colorChoice".

I exemplet används ett Choices objekt för att skapa en lista med acceptabla värden för colorChoice från en matris med String objekt. Ett Choices objekt motsvarar elementet one-of i SRGS-specifikationen och innehåller en uppsättning alternativa fraser, som alla kan identifieras när de talas. I exemplet används också ett Choices objekt för att gruppera en matris med två GrammarBuilder objekt i ett par alternativa fraser som den resulterande grammatiken kan känna igen. Alternativa ord eller fraser är en komponent i de flesta grammatiker, och objektet tillhandahåller den Choices här funktionen för grammatik som konstruerats med GrammarBuilder.

Exemplet skapar slutligen ett Grammar objekt från ett GrammarBuilder konstruerat objekt Choices .

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;
}

Kommentarer

Mer information om hur du skapar en taligenkännings grammatik som innehåller alternativ finns i Använda val för att skapa en grammatikbuilder grammatik.

Se även

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultKey ^ key);

public GrammarBuilder(System.Speech.Recognition.SemanticResultKey key);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultKey -> System.Speech.Recognition.GrammarBuilder

Public Sub New (key As SemanticResultKey)

Parametrar

Exempel

I följande exempel skapas en grammatik för taligenkänning som kan känna igen de två fraserna "Make background colorChoice" och "Set background to colorChoice", där colorChoice väljs från en uppsättning färger. Grammatiken låter en användare tala något av flera färgnamn och returnerar semantisk information om det identifierade färgnamnet till programmet.

I exemplet används en enda SemanticResultKey som du kan hämta som SemanticValue är associerad med den färg som användaren har talat med. Om indata till exempel innehåller frasen "Ange bakgrund till röd" innehåller igenkänningsresultatet det semantiska värdet "#FF0000", som du kan hämta med hjälp av en hanterare för SpeechRecognized händelsen.

I exemplet används String, Choices, SemanticResultKey, SemanticResultValueoch GrammarBuilder -objekt för att skapa de begränsningar som alla finns i det sista GrammarBuilder objektet, bothPhrases. Slutligen konstruerar exemplet ett Grammar objekt från den slutförda GrammarBuilder.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  // Include semantic information about each of the colors.
  Choices colorChoice = new Choices();

  GrammarBuilder colorBuilder = new GrammarBuilder("red");
  SemanticResultValue colorValue =
    new SemanticResultValue(colorBuilder, "#FF0000");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("green");
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("blue");
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
  colorChoice.Add(new GrammarBuilder(colorValue));

  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 object for the two alternative phrases.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  // Create the semantic key for referencing the color information.
  SemanticResultKey colorKey =
    new SemanticResultKey("ColorCode", bothPhrases);
  bothPhrases = new GrammarBuilder(colorKey);

  // Construct the Grammar object from the GrammarBuilder.
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Kommentarer

När du skapar en GrammarBuilder instans från ett SemanticResultValue objekt lägger du till semantisk information i grammatiken som kan returneras i igenkänningsresultatet. Du kan komma åt semantisk information i igenkänningsresultatet Semantics med egenskapen RecognizedPhrase, som är tillgänglig i hanteraren för SpeechRecognized händelsen. GrammarBuilder Om definierar en SemanticResultKeykan detta användas för att hämta semantisk information i ett igenkänningsresultat som är associerat med nyckeln. Se exemplet för Append(SemanticResultKey), och se SemanticResultValue även och SemanticResultKey.

Se även

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::SemanticResultValue ^ value);

public GrammarBuilder(System.Speech.Recognition.SemanticResultValue value);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.SemanticResultValue -> System.Speech.Recognition.GrammarBuilder

Public Sub New (value As SemanticResultValue)

Parametrar

Exempel

I följande exempel skapas en grammatik för taligenkänning som kan känna igen de två fraserna "Make background colorChoice" och "Set background to colorChoice", där colorChoice väljs från en uppsättning färger. Grammatiken låter en användare tala något av flera färgnamn och returnerar semantisk information om det identifierade färgnamnet till programmet.

I exemplet används en enda SemanticResultKey som du kan hämta som SemanticValue är associerad med den färg som användaren har talat med. Om indata till exempel innehåller frasen "Ange bakgrund till röd" innehåller igenkänningsresultatet det semantiska värdet "#FF0000", som du kan hämta med hjälp av en hanterare för SpeechRecognized händelsen.

I exemplet används String, Choices, SemanticResultKey, SemanticResultValueoch GrammarBuilder -objekt för att skapa de begränsningar som alla finns i det sista GrammarBuilder objektet, bothPhrases. Slutligen konstruerar exemplet ett Grammar objekt från den slutförda GrammarBuilder.

private Grammar CreateColorGrammar()
{

  // Create a set of color choices.
  // Include semantic information about each of the colors.
  Choices colorChoice = new Choices();

  GrammarBuilder colorBuilder = new GrammarBuilder("red");
  SemanticResultValue colorValue =
    new SemanticResultValue(colorBuilder, "#FF0000");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("green");
  colorValue = new SemanticResultValue(colorBuilder, "#00FF00");
  colorChoice.Add(new GrammarBuilder(colorValue));

  colorBuilder = new GrammarBuilder("blue");
  colorValue = new SemanticResultValue(colorBuilder, "#0000FF");
  colorChoice.Add(new GrammarBuilder(colorValue));

  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.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  GrammarBuilder bothPhrases = new GrammarBuilder(bothChoices);

  // Create the semantic key for referencing the color information.
  SemanticResultKey colorKey =
    new SemanticResultKey("ColorCode", bothPhrases);
  bothPhrases = new GrammarBuilder(colorKey);

  // Construct the grammar from the grammar builder.
  Grammar grammar = new Grammar(bothPhrases);
  grammar.Name = "backgroundColor";
  return grammar;
}

Kommentarer

När du skapar en GrammarBuilder instans från ett SemanticResultValue objekt lägger du till semantisk information i grammatiken som kan returneras i igenkänningsresultatet. Du kan komma åt semantisk information i igenkänningsresultatet Semantics med egenskapen RecognizedPhrase, som är tillgänglig i hanteraren för SpeechRecognized händelsen. GrammarBuilder Om definierar en SemanticResultKeykan detta användas för att hämta semantisk information i ett igenkänningsresultat som är associerat med nyckeln. Se exemplet för Append(SemanticResultKey), och se SemanticResultValue även och SemanticResultKey.

Se även

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::String ^ phrase);

public GrammarBuilder(string phrase);

new System.Speech.Recognition.GrammarBuilder : string -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String)

Parametrar

Exempel

I följande exempel används GrammarBuilder och Choices objekt för att konstruera en grammatik som kan känna igen någon av de två fraserna, "Make background colorChoice" eller "Set background to colorChoice".

När du har skapat en lista över godtagbara värden för colorChoice med hjälp av ett Choices objekt initierar exemplet två GrammarBuilder objekt makePhrase och setPhrase, med hjälp av en sträng som ett argument.

Exemplet skapar slutligen ett Grammar objekt från ett Choices objekt som gjuts till ett GrammarBuilder objekt.

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 object from the result.
  Choices bothChoices = new Choices(new GrammarBuilder[] {makePhrase, setPhrase});
  Grammar grammar = new Grammar((GrammarBuilder)bothChoices);
  grammar.Name = "backgroundColor";
  return grammar;
}

Kommentarer

Frasen representerar en exakt talad fras som grammatiken för taligenkänning kan känna igen. Mer information om hur du skapar en grammatik för taligenkänning som innehåller strängar finns i Använda strängar för att skapa en grammatikskapande grammatik.

Se även

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::String ^ phrase, System::Speech::Recognition::SubsetMatchingMode subsetMatchingCriteria);

public GrammarBuilder(string phrase, System.Speech.Recognition.SubsetMatchingMode subsetMatchingCriteria);

new System.Speech.Recognition.GrammarBuilder : string * System.Speech.Recognition.SubsetMatchingMode -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String, subsetMatchingCriteria As SubsetMatchingMode)

Parametrar

Exempel

I följande exempel skapas en grammatik för taligenkänning för varje SubsetMatchingMode värde och en grammatik för att välja mellan matchande läges grammatiker. Om värdet phrase för är "en två tre tre fyra fem sex sju", då subsequence grammatik känner igen indata "två tre fyra", men inte indata "en tre fem". Den ordnade underuppsättningens grammatik identifierar dock båda dessa indata.

private static IEnumerable<Grammar>
  CreateMatchingModeGrammars(string phrase)
{
  List<Grammar> grammars = new List<Grammar>(5);

  Choices modeChoice = new Choices();
  Type enumType = typeof(SubsetMatchingMode);
  foreach (SubsetMatchingMode mode in Enum.GetValues(enumType))
  {
    string modeName = Enum.GetName(enumType, mode);
    modeName = BreakAtCaps(modeName);

    GrammarBuilder builder = new GrammarBuilder(phrase, mode);
    Grammar modeGrammar = new Grammar(builder);
    modeGrammar.Name = modeName;
    modeGrammar.Enabled = false;
    grammars.Add(modeGrammar);

    modeChoice.Add(modeName);
  }

  Grammar choiceGrammar = new Grammar(modeChoice);
  choiceGrammar.Name = "choice";
  grammars.Add(choiceGrammar);

  return grammars;
}

// Insert spaces preceding each uppercase letter in a string.
private static string BreakAtCaps(string item)
{
  if (item == null || item.Length == 0)
  {
    return item;
  }

  StringBuilder sb = new StringBuilder(item[0].ToString());
  for (int i = 1; i < item.Length; i++)
  {
    char c = item[i];
    if (char.IsUpper(c))
    {
      sb.Append(" ");
    }
    sb.Append(c);
  }

  return sb.ToString();
}

Kommentarer

Parametern phrase representerar den fras som taligenkännings grammatiken kan känna igen. Parametern subsetMatchingMode anger en delmängd av frasen som kan talas för att uppnå lyckad igenkänning av hela frasen. Du kan använda detta för att skapa en grammatik med en lista med poster som har långa namn, utan att kräva att användarna talar ett helt namn för att matcha ett objekt.

Mer information om matchande lägen finns i SubsetMatchingMode. Mer information om hur du skapar en grammatik för taligenkänning som innehåller strängar finns i Använda strängar för att skapa en grammatikskapande grammatik.

Se även

• SubsetMatchingMode

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::Speech::Recognition::GrammarBuilder ^ builder, int minRepeat, int maxRepeat);

public GrammarBuilder(System.Speech.Recognition.GrammarBuilder builder, int minRepeat, int maxRepeat);

new System.Speech.Recognition.GrammarBuilder : System.Speech.Recognition.GrammarBuilder * int * int -> System.Speech.Recognition.GrammarBuilder

Public Sub New (builder As GrammarBuilder, minRepeat As Integer, maxRepeat As Integer)

Parametrar

Exempel

I följande exempel skapas en grammatik för taligenkänning för att beställa en pizza. Det börjar med en valfri, inledande fras, följt av en till fyra toppings, och avslutas med ordet "pizza".

private static Grammar CreatePizzaGrammar()
{

  // Create a Choices object from a string array of alternative toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
  andToppings.Append(toppings);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(toppings);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));
  gb.Append("pizza");

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;
}

Kommentarer

Om värdet minRepeat för är 0 representerar det nya GrammarBuilder ett valfritt element.

Värdet minRepeat för måste vara större än eller lika med 0 och mindre än eller lika med värdet för maxRepeat.

Se även

• Choices
• Grammar

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

Källa:

GrammarBuilder.cs

public:
 GrammarBuilder(System::String ^ phrase, int minRepeat, int maxRepeat);

public GrammarBuilder(string phrase, int minRepeat, int maxRepeat);

new System.Speech.Recognition.GrammarBuilder : string * int * int -> System.Speech.Recognition.GrammarBuilder

Public Sub New (phrase As String, minRepeat As Integer, maxRepeat As Integer)

Parametrar

Exempel

I följande exempel skapas en grammatik för taligenkänning för att beställa en pizza. Det börjar med en valfri, inledande fras, följt av en till fyra toppings, och avslutas med ordet "pizza".

private static Grammar CreatePizzaGrammar()
{

  // Create a Choices object with alternatives for toppings.
  Choices toppings = new Choices(new string[] {
    "cheese", "mushroom", "tomato", "onion",
    "anchovy", "chicken", "pepperoni"});

  // Create a GrammarBuilder and append the Choices object.
  GrammarBuilder andToppings = new GrammarBuilder("and", 0, 1);
  andToppings.Append(toppings);

  // Construct the phrase.
  GrammarBuilder gb = new GrammarBuilder("I would like a", 0, 1);
  gb.Append(toppings);
  gb.Append(new GrammarBuilder(andToppings, 0, 3));
  gb.Append("pizza");

  // Create the Grammar from the GrammarBuilder.
  Grammar grammar = new Grammar(gb);
  grammar.Name = "Pizza Order";

  return grammar;
}

Kommentarer

Om värdet minRepeat för är 0 representerar det nya GrammarBuilder ett valfritt element.

Värdet minRepeat för måste vara större än eller lika med 0 och mindre än eller lika med värdet för maxRepeat. Mer information om hur du skapar en grammatik för taligenkänning som innehåller strängar finns i Använda strängar för att skapa en grammatikskapande grammatik.

Se även

• Choices
• Grammar