GrammarBuilder Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe GrammarBuilder.
Sobrecargas
GrammarBuilder() |
Inicializa uma nova instância vazia da classe GrammarBuilder. |
GrammarBuilder(Choices) |
Inicializa uma nova instância da classe GrammarBuilder de um conjunto de alternativas. |
GrammarBuilder(SemanticResultKey) |
Inicializa uma nova instância da classe GrammarBuilder de uma chave semântica. |
GrammarBuilder(SemanticResultValue) |
Inicializa uma nova instância da classe GrammarBuilder de um valor semântico. |
GrammarBuilder(String) |
Inicializa uma nova instância da classe GrammarBuilder de uma sequência de palavras. |
GrammarBuilder(String, SubsetMatchingMode) |
Inicializa uma nova instância da classe GrammarBuilder para um subconjunto de uma sequência de palavras. |
GrammarBuilder(GrammarBuilder, Int32, Int32) |
Inicializa uma nova instância da classe GrammarBuilder de um elemento repetido. |
GrammarBuilder(String, Int32, Int32) |
Inicializa uma nova instância da classe GrammarBuilder da sequência de palavras em uma String e especifica quantas vezes a String pode ser repetida. |
Comentários
Instâncias dessa classe também podem ser obtidas por conversões implícitas de outras classes ou combinando um GrammarBuilder objeto com um segundo objeto para de um novo GrammarBuilder. Para obter mais informações, consulte os Implicit métodos e Addition .
Para adicionar restrições a um existente GrammarBuilder, use os Addmétodos , Append, AppendDictation, AppendRuleReferencee e AppendWildcard o Addition operador .
Importante
O reconhecedor de fala pode gerar uma exceção ao usar uma gramática de reconhecimento de fala que contém elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente o valor do mesmo elemento semântico.
Para obter mais informações sobre como criar e usar gramáticas de reconhecimento de fala, consulte Reconhecimento de Fala.
GrammarBuilder()
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância vazia da classe GrammarBuilder.
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 .
Importante
O reconhecedor de fala pode gerar uma exceção ao usar uma gramática de reconhecimento de fala que contém elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente o valor do mesmo elemento semântico.
Confira também
Aplica-se a
GrammarBuilder(Choices)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder de um conjunto de alternativas.
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
- alternateChoices
- Choices
O conjunto de alternativas.
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
Aplica-se a
GrammarBuilder(SemanticResultKey)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder de uma chave semântica.
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
A chave semântica.
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.
Importante
Ao construir GrammarBuilder objetos que contêm SemanticResultValue ou SemanticResultKey instâncias, evite criar elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente a Value propriedade de um SemanticValue objeto. O reconhecedor de fala poderá gerar uma exceção se encontrar essas circunstâncias.
Confira também
Aplica-se a
GrammarBuilder(SemanticResultValue)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder de um valor semântico.
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
- value
- SemanticResultValue
O par nome-valor ou o valor semântico.
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.
Importante
Ao construir GrammarBuilder objetos que contêm SemanticResultValue ou SemanticResultKey instâncias, evite criar elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente a Value propriedade de um SemanticValue objeto. O reconhecedor de fala poderá gerar uma exceção se encontrar essas circunstâncias.
Confira também
Aplica-se a
GrammarBuilder(String)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder de uma sequência de palavras.
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
- phrase
- String
A sequência de palavras.
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
Aplica-se a
GrammarBuilder(String, SubsetMatchingMode)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder para um subconjunto de uma sequência de palavras.
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
- phrase
- String
A sequência de palavras.
- subsetMatchingCriteria
- SubsetMatchingMode
O modo correspondente que a gramática de reconhecimento de fala usa para reconhecer a frase.
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
Aplica-se a
GrammarBuilder(GrammarBuilder, Int32, Int32)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder de um elemento repetido.
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
- builder
- GrammarBuilder
O elemento repetido.
- minRepeat
- Int32
O número mínimo de vezes que a entrada correspondente ao elemento definido por builder
deve ocorrer para constituir uma correspondência.
- maxRepeat
- Int32
O número máximo de vezes que a entrada correspondente ao elemento definido por builder
pode ocorrer para constituir uma correspondência.
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
.
Importante
Quando você especificar repetições para GrammarBuilder objetos que contêm SemanticResultValue ou SemanticResultKey instâncias, evite criar elementos semânticos duplicados com o mesmo nome de chave ou vários elementos semânticos que poderiam modificar repetidamente a Value propriedade de um SemanticValue objeto. O reconhecedor de fala poderá gerar uma exceção se encontrar essas circunstâncias.
Confira também
Aplica-se a
GrammarBuilder(String, Int32, Int32)
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
- Origem:
- GrammarBuilder.cs
Inicializa uma nova instância da classe GrammarBuilder da sequência de palavras em uma String e especifica quantas vezes a String pode ser repetida.
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
- phrase
- String
A sequência de palavras repetida.
- minRepeat
- Int32
O número mínimo de vezes que a entrada correspondente à frase deve ocorrer para constituir uma correspondência.
- maxRepeat
- Int32
O número máximo de vezes que a entrada correspondente à frase pode ocorrer para constituir uma correspondência.
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.