GrammarBuilder Класс

Определение

public ref class GrammarBuilder

public class GrammarBuilder

type GrammarBuilder = class

Public Class GrammarBuilder

Наследование

Object

GrammarBuilder

Примеры

В следующем примере используются GrammarBuilder Choices объекты и для создания грамматики, которая может распознать любую из двух фраз: «make Background колорчоице» или «Set Background to колорчоице».

В примере используется Choices объект для создания списка допустимых значений для колорчоице из массива String объектов. ChoicesОбъект является аналогом one-of элемента в спецификации SRGS и содержит набор альтернативных фраз, любой из которых можно распознать при разговоре. В примере также используется Choices объект для группирования массива из двух GrammarBuilder объектов в пару альтернативных фраз, которые может распознать результирующая грамматика. Альтернативные слова или фразы являются компонентом большинства грамматик, а Choices объект предоставляет эту функцию для грамматик, созданных с помощью GrammarBuilder .

В примере наконец создается Grammar объект из, GrammarBuilder созданного на основе 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;  
}  

Комментарии

Грамматики распознавания речи обычно создаются в формате XML, определенном в спецификации грамматики распознавания речи (SRGS) версии 1,0. Если вы знакомы с SRGS, но хотите создать грамматики программно, можно использовать System.Speech.Recognition.SrgsGrammar пространство имен, члены которого близко соответствуют элементам и атрибутам, определенным в SRGS. Если вы не знакомы с SRGS или хотите использовать упрощенный, программный подход к созданию грамматик, с помощью которых можно эффективно выполнять многие распространенные сценарии; можно использовать GrammarBuilder Choices классы и.

Используйте GrammarBuilder объекты для создания иерархического дерева, состоящего из Choices объектов, содержащих альтернативные фразы, в которых используются фразы преамбулы и POST-преамбулы на каждом узле, а также начальные значения, которые передают значение обратно в приложение.

Чтобы GrammarBuilder создать объект с помощью Grammar , выполните следующие действия.

1. Создание объекта GrammarBuilder.

2. Добавление ограничений к GrammarBuilder , таким как объекты,,,, String Choices SemanticResultKey SemanticResultValue DictationGrammar и другие GrammarBuilder объекты, определяющие ограничения грамматики.

3. Используйте один из Grammar конструкторов для создания Grammar объекта из завершенной GrammarBuilder грамматики.

Разработка с помощью GrammarBuilder лучше всего подходит для грамматики с одним правилом, содержащим списки, или, возможно, списки. Чтобы программно создать грамматики с несколькими правилами или ссылки на внутренние правила, используйте классы System.Speech.Recognition.SrgsGrammar пространства имен.

Экземпляры GrammarBuilder также могут быть получены неявными преобразованиями из некоторых других классов или путем объединения GrammarBuilder со вторым объектом, который содержит ограничения для грамматики. Дополнительные сведения см. в описании Implicit Addition операторов и Add методов.

Чтобы добавить правила в существующую GrammarBuilder , используйте Add методы,, Append , AppendDictation AppendRuleReference и AppendWildcard .

Чтобы упростить отладку, DebugShowPhrases свойство возвращает текущее состояние в GrammarBuilder виде строки.

Конструкторы

Свойства

Методы

Операторы

Применяется к

См. также раздел

• Choices
• Grammar
• SemanticResultKey
• SemanticResultValue