GrammarBuilder Constructeurs

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

public:
 GrammarBuilder();

public GrammarBuilder ();

Public Sub New ()

Exemples

L’exemple suivant utilise des GrammarBuilder objets et Choices pour construire une grammaire qui peut reconnaître l’une des deux expressions , « Make background colorChoice » ou « Set background to colorChoice ».

L’exemple utilise un Choices objet pour créer une liste de valeurs acceptables pour colorChoice à partir d’un tableau d’objets String . Un Choices objet est analogue à l’élément one-of dans la spécification SRGS et contient un ensemble d’expressions alternatives, dont l’une peut être reconnue lorsqu’elle est parlée. L’exemple utilise également un Choices objet pour regrouper un tableau de deux GrammarBuilder objets dans une paire d’expressions alternatives que la grammaire résultante peut reconnaître. Les mots ou expressions de substitution sont un composant de la plupart des grammaires, et l’objet Choices fournit cette fonctionnalité pour les grammaires construites avec GrammarBuilder.

L’exemple crée enfin un Grammar objet à partir d’un GrammarBuilder construit à partir d’un Choices objet .

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

Remarques

Pour ajouter des règles à un objet existantGrammarBuilder, utilisez les Addméthodes , AppendAppendDictation, AppendRuleReference, et AppendWildcard et et l’opérateur Addition .

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant utilise des GrammarBuilder objets et Choices pour construire une grammaire qui peut reconnaître l’une des deux expressions , « Make background colorChoice » ou « Set background to colorChoice ».

L’exemple utilise un Choices objet pour créer une liste de valeurs acceptables pour colorChoice à partir d’un tableau d’objets String . Un Choices objet est analogue à l’élément one-of dans la spécification SRGS et contient un ensemble d’expressions alternatives, qui peuvent être reconnues lorsqu’elles sont parlées. L’exemple utilise également un Choices objet pour regrouper un tableau de deux GrammarBuilder objets dans une paire d’expressions alternatives que la grammaire résultante peut reconnaître. Les mots ou expressions de substitution sont un composant de la plupart des grammaires, et l’objet Choices fournit cette fonctionnalité pour les grammaires construites avec GrammarBuilder.

L’exemple crée enfin un Grammar objet à partir d’un GrammarBuilder construit à partir d’un Choices objet .

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

Remarques

Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des alternatives, consultez Using Choices to Create a GrammarBuilder Grammar.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale qui peut reconnaître les deux expressions , « Make background colorChoice » et « Set background to colorChoice », où colorChoice est sélectionné à partir d’un ensemble de couleurs. La grammaire permet à un utilisateur de parler plusieurs noms de couleurs et retourne des informations sémantiques sur le nom de couleur reconnu à l’application.

L’exemple utilise un seul SemanticResultKey avec lequel vous pouvez récupérer le SemanticValue associé à la couleur parlée par l’utilisateur. Par exemple, si l’entrée contient l’expression « Définir l’arrière-plan sur rouge », le résultat de la reconnaissance contient la valeur sémantique « #FF0000 », que vous pouvez récupérer à l’aide d’un gestionnaire pour l’événement SpeechRecognized .

L’exemple utilise Stringdes objets , ChoicesSemanticResultKey, SemanticResultValue, et GrammarBuilder pour générer les contraintes contenues dans le dernier GrammarBuilder objet, bothPhrases. Enfin, l’exemple construit un Grammar objet à partir du terminé 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;
}

Remarques

Lorsque vous créez une GrammarBuilder instance à partir d’un SemanticResultValue objet, vous ajoutez des informations sémantiques à la grammaire qui peuvent être retournées dans le résultat de la reconnaissance. Vous pouvez accéder aux informations sémantiques dans le résultat de la reconnaissance à l’aide de la Semantics propriété de RecognizedPhrase, qui est disponible dans le gestionnaire de l’événement SpeechRecognized . Si définit GrammarBuilder un SemanticResultKey, il peut être utilisé pour récupérer les informations sémantiques dans un résultat de reconnaissance associé à la clé. Consultez l’exemple pour Append(SemanticResultKey), et consultez SemanticResultValue également et SemanticResultKey.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale qui peut reconnaître les deux expressions , « Make background colorChoice » et « Set background to colorChoice », où colorChoice est sélectionné à partir d’un ensemble de couleurs. La grammaire permet à un utilisateur de parler plusieurs noms de couleurs et retourne des informations sémantiques sur le nom de couleur reconnu à l’application.

L’exemple utilise un seul SemanticResultKey avec lequel vous pouvez récupérer le SemanticValue associé à la couleur parlée par l’utilisateur. Par exemple, si l’entrée contient l’expression « Définir l’arrière-plan sur rouge », le résultat de la reconnaissance contient la valeur sémantique « #FF0000 », que vous pouvez récupérer à l’aide d’un gestionnaire pour l’événement SpeechRecognized .

L’exemple utilise Stringdes objets , ChoicesSemanticResultKey, SemanticResultValue, et GrammarBuilder pour générer les contraintes contenues dans le dernier GrammarBuilder objet, bothPhrases. Enfin, l’exemple construit un Grammar objet à partir du terminé 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;
}

Remarques

Lorsque vous créez une GrammarBuilder instance à partir d’un SemanticResultValue objet, vous ajoutez des informations sémantiques à la grammaire qui peuvent être retournées dans le résultat de la reconnaissance. Vous pouvez accéder aux informations sémantiques dans le résultat de la reconnaissance à l’aide de la Semantics propriété de RecognizedPhrase, qui est disponible dans le gestionnaire de l’événement SpeechRecognized . Si définit GrammarBuilder un SemanticResultKey, il peut être utilisé pour récupérer les informations sémantiques dans un résultat de reconnaissance associé à la clé. Consultez l’exemple pour Append(SemanticResultKey), et consultez SemanticResultValue également et SemanticResultKey.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant utilise des GrammarBuilder objets et Choices pour construire une grammaire qui peut reconnaître l’une des deux expressions , « Make background colorChoice » ou « Set background to colorChoice ».

Après avoir créé une liste de valeurs acceptables pour colorChoice à l’aide d’un Choices objet, l’exemple initialise deux GrammarBuilder objets et makePhrasesetPhrase, en utilisant une chaîne comme argument.

L’exemple crée enfin un Grammar objet à partir d’un Choices cast d’objet en objet GrammarBuilder .

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

Remarques

L’expression représente une expression parlée exacte que la grammaire de reconnaissance vocale peut reconnaître. Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des chaînes, consultez Utilisation de chaînes pour créer une grammaire GrammarBuilder.

Voir aussi

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour chaque SubsetMatchingMode valeur et une grammaire pour le choix entre les grammaires du mode correspondant. Si la valeur de phrase est « un deux trois quatre cinq six sept », la grammaire de sous-séquence reconnaît l’entrée « deux trois quatre », mais pas l’entrée « un trois cinq ». Toutefois, la grammaire du sous-ensemble ordonné reconnaît ces deux entrées.

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

Remarques

Le phrase paramètre représente l’expression que la grammaire de reconnaissance vocale peut reconnaître. Le subsetMatchingMode paramètre spécifie un sous-ensemble de l’expression qui peut être prononcé pour réussir la reconnaissance de l’ensemble de l’expression. Vous pouvez l’utiliser pour créer une grammaire avec une liste d’entrées qui ont des noms longs, sans exiger que les utilisateurs parlent un nom entier pour correspondre à un élément.

Pour plus d’informations sur les modes de correspondance, consultez SubsetMatchingMode. Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des chaînes, consultez Utilisation de chaînes pour créer une grammaire GrammarBuilder.

Voir aussi

• SubsetMatchingMode

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour la commande d’une pizza. Elle commence par une phrase d’ouverture facultative, suivie d’une à quatre garnitures et se termine par le mot « 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;
}

Remarques

Si la valeur de minRepeat est 0, le nouveau GrammarBuilder représente un élément facultatif.

La valeur de minRepeat doit être supérieure ou égale à 0 et inférieure ou égale à la valeur de maxRepeat.

Voir aussi

• Choices
• Grammar

Source:

GrammarBuilder.cs

Source:

GrammarBuilder.cs

Source:

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)

Paramètres

Exemples

L’exemple suivant crée une grammaire de reconnaissance vocale pour la commande d’une pizza. Elle commence par une phrase d’ouverture facultative, suivie d’une à quatre garnitures et se termine par le mot « 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;
}

Remarques

Si la valeur de minRepeat est 0, le nouveau GrammarBuilder représente un élément facultatif.

La valeur de minRepeat doit être supérieure ou égale à 0 et inférieure ou égale à la valeur de maxRepeat. Pour plus d’informations sur la création d’une grammaire de reconnaissance vocale qui contient des chaînes, consultez Utilisation de chaînes pour créer une grammaire GrammarBuilder.

Voir aussi

• Choices
• Grammar