语言

GrammarBuilder 类

定义

提供一种机制,用于以编程方式构建语音识别语法的约束。

public ref class GrammarBuilder
public class GrammarBuilder
type GrammarBuilder = class
Public Class GrammarBuilder
继承
GrammarBuilder

示例

以下示例使用 GrammarBuilder 和 Choices 对象构造一个语法,该语法可以识别两个短语之一“生成背景 颜色Choice”或“将背景设置为 colorChoice”。

该示例使用对象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;
}

注解

语音识别语法通常采用语音识别 语法规范 (SRGS) 版本 1.0 定义的 XML 格式创作。 如果你熟悉 SRGS,但想要以编程方式生成语法,则可以使用 System.Speech.Recognition.SrgsGrammar 命名空间,其成员与 SRGS 定义的元素和属性密切相关。 如果你不熟悉 SRGS,或者想要一种轻量级的编程方法来创作语法,你可以有效地完成许多常见方案:可以使用 GrammarBuilder 和 Choices 类。

使用 GrammarBuilder 对象生成由对象组成的 Choices 分层树,这些对象包含备用短语、插入每个节点上的前言和后 amble 短语,并用语义值进行种子设定,这些语义值将含义传达回应用程序。

若要使用 a GrammarBuilder 创建 Grammar 对象,请使用以下步骤。

  1. 创建 GrammarBuilder 对象。

  2. 将约束追加到GrammarBuilderString用于定义语法约束的对象、Choices、SemanticResultKey、SemanticResultValueDictationGrammar以及定义约束的其他GrammarBuilder对象。

  3. 使用其中一个Grammar构造函数从已完成Grammar的语法创建GrammarBuilder对象。

使用 GrammarBuilder 创作最适用于包含列表的单个规则或列表列表的语法。 若要以编程方式生成具有多个规则的语法,或者需要进行内部规则引用,请使用命名空间的 System.Speech.Recognition.SrgsGrammar 类。

GrammarBuilder也可以通过从某些其他类的隐式转换或使用包含语法约束的第二个对象来GrammarBuilder获取实例。 有关详细信息,请参阅 Implicit 和 Addition 运算符和 Add 方法。

若要向现有规则添加规则,请使用 > 和方法。

Important

当使用包含具有相同键名的重复语义元素或多个语义元素的语音识别语法时,语音识别器可能会引发异常,这些元素可以重复修改同一语义元素的值。

为了帮助调试,该 DebugShowPhrases 属性将返回字符串的 GrammarBuilder 当前状态。

构造函数

名称 说明
GrammarBuilder()

初始化类的新空实例 GrammarBuilder 。

GrammarBuilder(Choices)

从一组替代项初始化类的新实例 GrammarBuilder 。

GrammarBuilder(GrammarBuilder, Int32, Int32)

从重复元素初始化类的新实例 GrammarBuilder 。

GrammarBuilder(SemanticResultKey)

从语义键初始化类的新实例 GrammarBuilder 。

GrammarBuilder(SemanticResultValue)

从语义值初始化类的新实例 GrammarBuilder 。

GrammarBuilder(String, Int32, Int32)

从单词序列GrammarBuilder初始化类的新实例String,并指定可重复的次数String。

GrammarBuilder(String, SubsetMatchingMode)

为一系列单词的子集初始化类的新实例 GrammarBuilder 。

GrammarBuilder(String)

从单词序列初始化类的新实例 GrammarBuilder 。

属性

名称 说明
Culture

获取或设置语音识别语法的区域性。

DebugShowPhrases

获取一个字符串,该字符串显示包含的 GrammarBuilder语法的内容和结构。

方法

名称 说明
Add(Choices, GrammarBuilder)

创建一个包含GrammarBuilder对象后跟Choices对象的新GrammarBuilder对象。

Add(GrammarBuilder, Choices)

创建一个包含GrammarBuilder对象后跟GrammarBuilder对象的新Choices对象。

Add(GrammarBuilder, GrammarBuilder)

创建一个包含两GrammarBuilder个对象的序列的新GrammarBuilder对象。

Add(GrammarBuilder, String)

创建一个包含GrammarBuilder后跟短语的对象的新GrammarBuilder对象。

Add(String, GrammarBuilder)

创建一个包含后跟GrammarBuilder对象的短语的新GrammarBuilder内容。

Append(Choices)

将一组替代项追加到当前语法元素序列。

Append(GrammarBuilder, Int32, Int32)

将重复的语法元素追加到当前语法元素序列中。

Append(GrammarBuilder)

将语法元素追加到当前语法元素序列中。

Append(SemanticResultKey)

将语义键追加到当前语法元素序列中。

Append(SemanticResultValue)

将语义值追加到语法元素的当前序列中。

Append(String, Int32, Int32)

将重复的短语追加到当前语法元素序列中。

Append(String, SubsetMatchingMode)

将短语子集的元素追加到当前语法元素序列中。

Append(String)

将短语追加到当前语法元素序列中。

AppendDictation()

将默认听写语法追加到当前语法元素序列中。

AppendDictation(String)

将指定的听写语法追加到当前语法元素序列中。

AppendRuleReference(String, String)

将语法定义文件的指定规则追加到当前语法元素序列中。

AppendRuleReference(String)

将语法定义文件追加到当前语法元素序列中。

AppendWildcard()

追加一个识别语法元素,该元素与当前语法元素序列匹配的任何输入。

Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type。

(继承自 Object)
MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
ToString()

返回一个表示当前对象的字符串。

(继承自 Object)

运算符

名称 说明
Addition(Choices, GrammarBuilder)

创建一个包含GrammarBuilder对象后跟Choices对象的新GrammarBuilder对象。

Addition(GrammarBuilder, Choices)

创建一个包含GrammarBuilder后跟 a 的一个新GrammarBuilderChoices项。

Addition(GrammarBuilder, GrammarBuilder)

创建一个包含两GrammarBuilder个对象的序列的新GrammarBuilder对象。

Addition(GrammarBuilder, String)

创建一个包含GrammarBuilder后跟短语的新GrammarBuilder内容。

Addition(String, GrammarBuilder)

创建一个包含后跟一个GrammarBuilder短语的新GrammarBuilder项。

Implicit(Choices to GrammarBuilder)

将 Choices 对象转换为 GrammarBuilder 对象。

Implicit(SemanticResultKey to GrammarBuilder)

将 SemanticResultKey 对象转换为 GrammarBuilder 对象。

Implicit(SemanticResultValue to GrammarBuilder)

将 SemanticResultValue 对象转换为 GrammarBuilder 对象。

Implicit(String to GrammarBuilder)

将字符串转换为 GrammarBuilder 对象。

适用于

另请参阅