GrammarBuilder Construtores

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

Origem:

GrammarBuilder.cs

public:
 GrammarBuilder();

public GrammarBuilder();

Public Sub New ()

Exemplos

O exemplo seguinte usa GrammarBuilder um Choices objeto para construir uma gramática capaz de reconhecer qualquer uma das duas frases, "Fazer a escolha de cor do fundo" ou "Definir o fundo para escolhaColor".

O exemplo utiliza um Choices objeto para criar uma lista de valores aceitáveis para colorChoice a partir de um array de String objetos. Um Choices objeto é análogo ao one-of elemento da especificação SRGS e contém um conjunto de frases alternativas, qualquer uma das quais pode ser reconhecida quando pronunciada. O exemplo também usa um Choices objeto para agrupar um array de dois GrammarBuilder objetos num 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 esta funcionalidade para gramáticas construídas com GrammarBuilder.

O exemplo cria finalmente um Grammar objeto a partir 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;
}

Observações

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

Ver também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

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 seguinte usa GrammarBuilder um Choices objeto para construir uma gramática capaz de reconhecer qualquer uma das duas frases, "Fazer a escolha de cor do fundo" ou "Definir o fundo para escolhaColor".

O exemplo utiliza um Choices objeto para criar uma lista de valores aceitáveis para colorChoice a partir de um array de String objetos. Um Choices objeto é análogo ao one-of elemento da especificação SRGS e contém um conjunto de frases alternativas, qualquer uma das quais pode ser reconhecida quando pronunciada. O exemplo também usa um Choices objeto para agrupar um array de dois GrammarBuilder objetos num 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 esta funcionalidade para gramáticas construídas com GrammarBuilder.

O exemplo cria finalmente um Grammar objeto a partir 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;
}

Observações

Para mais informações sobre como construir uma gramática de reconhecimento de fala que contenha alternativas, consulte Usar Escolhas para Criar uma Gramática Builder.

Ver também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

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 seguinte cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Make backgroundColorChoice" e "Set background to colorChoice", onde colorChoice é selecionada a partir de um conjunto de cores. A gramática permite ao utilizador falar qualquer um dos vários nomes de cor e devolve informações semânticas sobre o nome de cor reconhecida à aplicação.

O exemplo usa um único SemanticResultKey com o qual pode recuperar o SemanticValue que está associado à cor falada pelo utilizador. Por exemplo, se a entrada contiver a frase "Definir fundo a vermelho", o resultado de reconhecimento contém o valor semântico de "#FF0000", que pode recuperar usando um handler para o SpeechRecognized evento.

O exemplo usa , , , , e String objetos para construir as restrições que estão todas contidas no último Choices objeto, SemanticResultKey. SemanticResultValueGrammarBuilderGrammarBuilderbothPhrases Finalmente, o exemplo constrói um Grammar objeto a partir 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;
}

Observações

Quando crias uma GrammarBuilder instância a partir de um SemanticResultValue objeto, adicionas informação semântica à gramática que pode ser devolvida no resultado de reconhecimento. Pode aceder à informação semântica no resultado de reconhecimento usando a Semantics propriedade de RecognizedPhrase, que está disponível no handler do SpeechRecognized evento. Se o GrammarBuilder define um SemanticResultKey, isto pode ser usado para recuperar a informação semântica num resultado de reconhecimento associado à chave. Veja o exemplo para Append(SemanticResultKey), e veja SemanticResultValue também e SemanticResultKey.

Ver também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

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 seguinte cria uma gramática de reconhecimento de fala que pode reconhecer as duas frases, "Make backgroundColorChoice" e "Set background to colorChoice", onde colorChoice é selecionada a partir de um conjunto de cores. A gramática permite ao utilizador falar qualquer um dos vários nomes de cor e devolve informações semânticas sobre o nome de cor reconhecida à aplicação.

O exemplo usa um único SemanticResultKey com o qual pode recuperar o SemanticValue que está associado à cor falada pelo utilizador. Por exemplo, se a entrada contiver a frase "Definir fundo a vermelho", o resultado de reconhecimento contém o valor semântico de "#FF0000", que pode recuperar usando um handler para o SpeechRecognized evento.

O exemplo usa , , , , e String objetos para construir as restrições que estão todas contidas no último Choices objeto, SemanticResultKey. SemanticResultValueGrammarBuilderGrammarBuilderbothPhrases Finalmente, o exemplo constrói um Grammar objeto a partir 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;
}

Observações

Quando crias uma GrammarBuilder instância a partir de um SemanticResultValue objeto, adicionas informação semântica à gramática que pode ser devolvida no resultado de reconhecimento. Pode aceder à informação semântica no resultado de reconhecimento usando a Semantics propriedade de RecognizedPhrase, que está disponível no handler do SpeechRecognized evento. Se o GrammarBuilder define um SemanticResultKey, isto pode ser usado para recuperar a informação semântica num resultado de reconhecimento associado à chave. Veja o exemplo para Append(SemanticResultKey), e veja SemanticResultValue também e SemanticResultKey.

Ver também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

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 seguinte usa GrammarBuilder um Choices objeto para construir uma gramática capaz de reconhecer qualquer uma das duas frases, "Fazer a escolha de cor do fundo" ou "Definir o fundo para escolhaColor".

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

O exemplo cria finalmente um Grammar objeto de um Choices objeto lançado para 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;
}

Observações

A frase representa uma frase falada exata que a gramática de reconhecimento de fala consegue reconhecer. Para mais informações sobre como construir uma gramática de reconhecimento de voz que contenha cadeias, consulte Usar Cadeias para Criar uma Gramática GrammarBuilder.

Ver também

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue

Origem:

GrammarBuilder.cs

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 seguinte cria uma gramática de reconhecimento de fala para cada SubsetMatchingMode valor e uma gramática para escolher entre as gramáticas do modo de correspondência. Se o valor de phrase for "um dois três quatro cinco seis sete", então a gramática da subsequência reconhece a entrada "dois três quatro", mas não a entrada "um três cinco". No entanto, a gramática dos Subconjuntos Ordenados reconhece ambas estas 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();
}

Observações

O phrase parâmetro representa a frase que a gramática de reconhecimento de fala consegue reconhecer. O subsetMatchingMode parâmetro especifica um subconjunto da frase que pode ser pronunciado para alcançar o reconhecimento bem-sucedido da frase inteira. Pode usar isto para criar uma gramática com uma lista de entradas que tenham nomes longos, sem exigir que os utilizadores pronunciem um nome inteiro para corresponder a um item.

Para mais informações sobre os modos de correspondência, veja SubsetMatchingMode. Para mais informações sobre como construir uma gramática de reconhecimento de voz que contenha cadeias, consulte Usar Cadeias para Criar uma Gramática GrammarBuilder.

Ver também

• SubsetMatchingMode

Origem:

GrammarBuilder.cs

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 seguinte cria uma gramática de reconhecimento de fala para encomendar uma pizza. Começa com uma frase opcional de abertura, seguida de um a quatro toppings, e termina 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;
}

Observações

Se o valor de minRepeat for 0, então o novo GrammarBuilder representa um elemento opcional.

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

Ver também

• Choices
• Grammar

Origem:

GrammarBuilder.cs

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 seguinte cria uma gramática de reconhecimento de fala para encomendar uma pizza. Começa com uma frase opcional de abertura, seguida de um a quatro toppings, e termina 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;
}

Observações

Se o valor de minRepeat for 0, então o novo GrammarBuilder representa um elemento opcional.

O valor de minRepeat deve ser maior ou igual a 0 e menor ou igual ao valor de maxRepeat. Para mais informações sobre como construir uma gramática de reconhecimento de voz que contenha cadeias, consulte Usar Cadeias para Criar uma Gramática GrammarBuilder.

Ver também

• Choices
• Grammar