GrammarBuilder Construtores

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

public:
 GrammarBuilder();

public GrammarBuilder ();

Public Sub New ()

Exemplos

O exemplo a seguir usa GrammarBuilder objetos e Choices para construir uma gramática que possa reconhecer uma das duas frases, "Make background colorChoice" ou "Set background to colorChoice".

O exemplo usa um Choices objeto para criar uma lista de valores aceitáveis para colorChoice de uma matriz de String objetos. Um Choices objeto é análogo ao one-of elemento na especificação SRGS e contém um conjunto de frases alternativas, qualquer uma das quais pode ser reconhecida quando falada. O exemplo também usa um Choices objeto para agrupar uma matriz de dois GrammarBuilder objetos em um par de frases alternativas que a gramática resultante pode reconhecer. Palavras ou frases alternativas são um componente da maioria das gramáticas e o Choices objeto fornece essa funcionalidade para gramáticas construídas com GrammarBuilder.

O exemplo finalmente cria um Grammar objeto de um GrammarBuilder construído a partir de um Choices objeto .

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

Comentários

Para adicionar regras a um objeto existente GrammarBuilder , use os Addmétodos , Append, AppendDictation, AppendRuleReferencee AppendWildcard e e o Addition operador .

Confira também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir usa GrammarBuilder objetos e Choices para construir uma gramática que possa reconhecer uma das duas frases, "Make background colorChoice" ou "Set background to colorChoice".

O exemplo usa um Choices objeto para criar uma lista de valores aceitáveis para colorChoice de uma matriz de String objetos. Um Choices objeto é análogo ao one-of elemento na especificação SRGS e contém um conjunto de frases alternativas, qualquer uma das quais pode ser reconhecida quando falada. O exemplo também usa um Choices objeto para agrupar uma matriz de dois GrammarBuilder objetos em um par de frases alternativas que a gramática resultante pode reconhecer. Palavras ou frases alternativas são um componente da maioria das gramáticas e o Choices objeto fornece essa funcionalidade para gramáticas construídas com GrammarBuilder.

O exemplo finalmente cria um Grammar objeto de um GrammarBuilder construído a partir de um Choices objeto .

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

Comentários

Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contenha alternativas, consulte Usando opções para criar uma gramática grammarbuilder.

Confira também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Make background colorChoice" e "Set background to colorChoice", em que colorChoice é selecionado em um conjunto de cores. A gramática permite que um usuário fale qualquer um dos vários nomes de cores e retorna informações semânticas sobre o nome de cor reconhecido para o aplicativo.

O exemplo usa um único SemanticResultKey com o qual você pode recuperar o SemanticValue associado à cor falada pelo usuário. Por exemplo, se a entrada contiver a frase "Definir plano de fundo como vermelho", o resultado do reconhecimento conterá o valor semântico de "#FF0000", que você pode recuperar usando um manipulador para o SpeechRecognized evento.

O exemplo usa Stringobjetos , Choices, SemanticResultKey, SemanticResultValuee GrammarBuilder para criar as restrições que estão todas contidas no último GrammarBuilder objeto, bothPhrases. Por fim, o exemplo constrói um Grammar objeto do concluído 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;
}

Comentários

Ao criar uma GrammarBuilder instância de um SemanticResultValue objeto, você adiciona informações semânticas à gramática que podem ser retornadas no resultado do reconhecimento. Você pode acessar as informações semânticas no resultado do reconhecimento usando a Semantics propriedade de RecognizedPhrase, que está disponível no manipulador para o SpeechRecognized evento. Se o GrammarBuilder definir um SemanticResultKey, isso poderá ser usado para recuperar as informações semânticas em um resultado de reconhecimento associado à chave. Consulte o exemplo de Append(SemanticResultKey), e também veja SemanticResultValue e SemanticResultKey.

Confira também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Make background colorChoice" e "Set background to colorChoice", em que colorChoice é selecionado em um conjunto de cores. A gramática permite que um usuário fale qualquer um dos vários nomes de cores e retorna informações semânticas sobre o nome de cor reconhecido para o aplicativo.

O exemplo usa um único SemanticResultKey com o qual você pode recuperar o SemanticValue associado à cor falada pelo usuário. Por exemplo, se a entrada contiver a frase "Definir plano de fundo como vermelho", o resultado do reconhecimento conterá o valor semântico de "#FF0000", que você pode recuperar usando um manipulador para o SpeechRecognized evento.

O exemplo usa Stringobjetos , Choices, SemanticResultKey, SemanticResultValuee GrammarBuilder para criar as restrições que estão todas contidas no último GrammarBuilder objeto, bothPhrases. Por fim, o exemplo constrói um Grammar objeto do concluído 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;
}

Comentários

Ao criar uma GrammarBuilder instância de um SemanticResultValue objeto, você adiciona informações semânticas à gramática que podem ser retornadas no resultado do reconhecimento. Você pode acessar as informações semânticas no resultado do reconhecimento usando a Semantics propriedade de RecognizedPhrase, que está disponível no manipulador para o SpeechRecognized evento. Se o GrammarBuilder definir um SemanticResultKey, isso poderá ser usado para recuperar as informações semânticas em um resultado de reconhecimento associado à chave. Consulte o exemplo de Append(SemanticResultKey), e também veja SemanticResultValue e SemanticResultKey.

Confira também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir usa GrammarBuilder objetos e Choices para construir uma gramática que possa reconhecer uma das duas frases, "Make background colorChoice" ou "Set background to colorChoice".

Depois de criar uma lista de valores aceitáveis para colorChoice usando um Choices objeto , o exemplo inicializa dois GrammarBuilder objetos e setPhrase, usando uma cadeia de caracteres makePhrase como argumento.

O exemplo finalmente cria um Grammar objeto de um Choices objeto convertido em um GrammarBuilder objeto .

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

Comentários

A frase representa uma frase falada exata que a gramática de reconhecimento de fala pode reconhecer. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contenha cadeias de caracteres, consulte Usando cadeias de caracteres para criar uma gramática GrammarBuilder.

Confira também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para cada SubsetMatchingMode valor e uma gramática para escolher entre as gramáticas do modo correspondente. Se o valor de phrase for "um dois três quatro cinco seis sete", a gramática Subsequence reconhecerá a entrada "dois três quatro", mas não a entrada "um três cinco". No entanto, a gramática subconjunto ordenado reconhece ambas as entradas.

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

Comentários

O phrase parâmetro representa a frase que a gramática de reconhecimento de fala pode reconhecer. O subsetMatchingMode parâmetro especifica um subconjunto da frase que pode ser falado para obter o reconhecimento bem-sucedido de toda a frase. Você pode usar isso para criar uma gramática com uma lista de entradas que têm nomes longos, sem exigir que os usuários falem um nome inteiro para corresponder a um item.

Para obter mais informações sobre os modos correspondentes, consulte SubsetMatchingMode. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contenha cadeias de caracteres, consulte Usando cadeias de caracteres para criar uma gramática GrammarBuilder.

Confira também

• SubsetMatchingMode

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para pedir uma pizza. Ele começa com uma frase de abertura opcional, seguida de uma a quatro coberturas, e fecha com a palavra "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;
}

Comentários

Se o valor de minRepeat for 0, o novo GrammarBuilder representará um elemento opcional.

O valor de minRepeat deve ser maior ou igual a 0 e menor ou igual ao valor de maxRepeat.

Confira também

• Choices
• Grammar

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

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)

Parâmetros

Exemplos

O exemplo a seguir cria uma gramática de reconhecimento de fala para pedir uma pizza. Ele começa com uma frase de abertura opcional, seguida de uma a quatro coberturas, e fecha com a palavra "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;
}

Comentários

Se o valor de minRepeat for 0, o novo GrammarBuilder representará um elemento opcional.

O valor de minRepeat deve ser maior ou igual a 0 e menor ou igual ao valor de maxRepeat. Para obter mais informações sobre como criar uma gramática de reconhecimento de fala que contém cadeias de caracteres, consulte Usando cadeias de caracteres para criar uma gramática GrammarBuilder.

Confira também

• Choices
• Grammar