如何定义自定义识别约束 (HTML)

12/11/2015

本文内容

[ 本文适用于编写 Windows 运行时应用的 Windows 8.x 和 Windows Phone 8.x 开发人员。如果你要针对 Windows 10 进行开发，请参阅 最新文档 ]

了解如何为语音识别定义和使用自定义约束。

注意  在 Windows 8 和 Windows 8.1 中，Windows 应用商店应用不支持语音命令和语音识别。

语音识别至少需要一个约束，才能定义可识别的词汇。如果未指定任何约束，将使用 Universal Windows App 的预定义听写语法。请参阅快速入门：语音识别。

你需要了解的内容

技术

先决条件

本主题构建于快速入门：语音识别之上。

要完成该教程，请阅读这些主题来熟悉此处讨论的技术：

说明

步骤 1: 添加约束

我们在此处介绍三种可在应用内使用的语音识别约束。(有关语音命令约束，请参阅快速入门：语音命令。)

每个语音识别器都可具有一个约束集合。只有以下约束组合有效：

单个主题的约束，也称预定义语法(听写或 Web 搜索)。不允许使用其他约束。

列表约束和/或语法文件约束的组合。

步骤 2: 指定 Web 搜索语法 (SpeechRecognitionTopicConstraint)

必须将主题约束(听写或 Web 搜索语法)添加到语音识别器的约束集合。

在此，我们将 Web 搜索语法添加到约束集合。

function buttonSpeechRecognizerWebSearchClick() {

// Create an instance of SpeechRecognizer.

var speechRecognizer =

new Windows.Media.SpeechRecognition.SpeechRecognizer();

// Add a web search grammar to the recognizer.

var webSearchGrammar =

new Windows.Media.SpeechRecognition.SpeechRecognitionTopicConstraint(

Windows.Media.SpeechRecognition.SpeechRecognitionScenario.WebSearch,

"webSearch");

speechRecognizer.uiOptions.audiblePrompt = "Say what you want to search for...";

speechRecognizer.uiOptions.exampleText = "Ex. 'weather for London'";

speechRecognizer.constraints.append(webSearchGrammar);

// Compile the default dictation grammar.

speechRecognizer.compileConstraintsAsync().done(

// Success function.

function (result) {

// Start recognition.

speechRecognizer.recognizeWithUIAsync().done(

// Success function.

function (speechRecognitionResult) {

// Do something with the recognition result.

var messageDialog =

new Windows.UI.Popups.MessageDialog(

speechRecognitionResult.text, "Text spoken");

messageDialog.showAsync();

},

// Error function.

function (err) {

WinJS.log && WinJS.log("Speech recognition failed.");

});

},

// Error function.

function (err) {

WinJS.log && WinJS.log("Constraint compilation failed.");

});

speechRecognizer.close();

}

步骤 3: 指定编程列表约束 (SpeechRecognitionListConstraint)

必须将列表约束添加到语音识别器的约束集合。

请牢记以下几点：

你可以将多个列表约束添加到约束集合。

你可以使用为该字符串值实现 IIterable 的任何集合。

在此，我们以编程方式将一组字词指定为列表约束，并将其添加到语音识别器的约束集合中。

function buttonSpeechRecognizerListConstraintClick() {

// Create an instance of SpeechRecognizer.

var speechRecognizer =

new Windows.Media.SpeechRecognition.SpeechRecognizer();

// You could create this array dynamically.

var responses = ["Yes", "No"];

// Add a web search grammar to the recognizer.

var listConstraint =

new Windows.Media.SpeechRecognition.SpeechRecognitionListConstraint(

responses,

"YesOrNo");

speechRecognizer.uiOptions.audiblePrompt = "Say what you want to search for...";

speechRecognizer.uiOptions.exampleText = "Ex. 'Yes', 'No'";

speechRecognizer.constraints.append(listConstraint);

// Compile the default dictation grammar.

speechRecognizer.compileConstraintsAsync().done(

// Success function.

function (result) {

// Start recognition.

speechRecognizer.recognizeWithUIAsync().done(

// Success function.

function (speechRecognitionResult) {

// Do something with the recognition result.

var messageDialog =

new Windows.UI.Popups.MessageDialog(

speechRecognitionResult.text, "Text spoken");

messageDialog.showAsync();

},

// Error function.

function (err) {

WinJS.log && WinJS.log("Speech recognition failed.");

});

},

// Error function.

function (err) {

WinJS.log && WinJS.log("Constraint compilation failed.");

});

speechRecognizer.close();

}

步骤 4: 指定 SRGS 语法约束 (SpeechRecognitionGrammarFileConstraint)

必须将 SRGS 语法文件添加到语音识别器的约束集合。

SRGS 版本 1.0 是用于为语音识别创建 XML 格式语法的行业标准标记语言。尽管 Universal Windows App 为创建语音识别提供了使用 SRGS 的替代项，但是你可能会发现，使用 SRGS 创建语法产生的结果最好，尤其是对较复杂的语音识别方案。

SRGS 提供一组完整的功能，可帮助你为应用构建复杂的语音交互。例如，你可以使用 SRGS 语法执行以下操作：

指定字词和短语必须说出的顺序以供识别。

从多个列表和短语组合字词以供识别。

链接到其他语法。

对替代字词或短语分配权重以增加或减少它将被用于匹配语音输入的可能性。

包括可选字词或短语。

使用帮助筛选掉未指定或非预期输入(例如不匹配语法的随机语音或背景噪音)的特殊规则。

使用语义定义语音识别对你的应用的意义。

在语法中以内联方式或通过指向词典的链接来指定发音。

有关 SRGS 元素和属性的详细信息，请参阅 SRGS 语法 XML 参考。若要开始创建 SRGS 语法，请参阅如何创建基本的 XML 语法。

请牢记以下几点：

你可以将多个语法文件约束添加到约束集合。

为符合 SRGS 规则的基于 XML 的语法文件使用 .grxml 文件扩展名。

该示例使用在名为 srgs.grxml 的文件(稍后说明)中定义的 SRGS 语法。在文件属性中，“数据包操作”设置为“内容”，“复制到输出目录”则设置为“始终复制”。****

function buttonSpeechRecognizerSRGSConstraintClick() {

// Create an instance of SpeechRecognizer.

var speechRecognizer =

new Windows.Media.SpeechRecognition.SpeechRecognizer();

speechRecognizer.uiOptions.audiblePrompt = "Say what you want to search for...";

speechRecognizer.uiOptions.exampleText = "Ex. 'yes', 'no'";

// Add a grammar file constraint to the recognizer.

var uri = new Windows.Foundation.Uri("ms-appx:///data/srgs.grxml");

var storageFile =

Windows.Storage.StorageFile.getFileFromApplicationUriAsync(uri).then(

// Success function.

function (srgs) {

var grammarfileConstraint =

new Windows.Media.SpeechRecognition.SpeechRecognitionGrammarFileConstraint(srgs, "yesorno");

speechRecognizer.constraints.append(grammarfileConstraint);

// Compile the default dictation grammar.

speechRecognizer.compileConstraintsAsync().then(

// Success function.

function (result) {

// Start recognition.

speechRecognizer.recognizeWithUIAsync().done(

// Success function.

function (speechRecognitionResult) {

// Do something with the recognition result.

var messageDialog =

new Windows.UI.Popups.MessageDialog(

speechRecognitionResult.text, "Text spoken");

messageDialog.showAsync();

},

// Error function.

function (err) {

WinJS.log && WinJS.log("Speech recognition failed.");

});

},

// Error function.

function (err) {

WinJS.log && WinJS.log("Constraint compilation failed.");

});

},

// Error function.

function (err) {

WinJS.log && WinJS.log("File retrieval failed.");

});

speechRecognizer.close();

}

该 SRGS 文件 (srgs.grxml) 包含语义翻译标记。这些标记提供了用于将语法匹配数据返回应用的机制。 语法必须符合万维网联合会 (W3C) 用于语音识别的语义翻译 (SISR) 1.0 规范。

此处，我们侦听"是"和"否"的变体。

root="yesOrNo"

version="1.0"

tag-format="semantics/1.0"

xmlns="http://www.w3.org/2001/06/grammar">

yes

yeah

yep

yup

un huh

yay yus

out="yes";

no

nope

nah

uh uh

out="no";

步骤 5: 管理约束

在加载约束集合以供识别后，你的应用可以通过将约束的 IsEnabled 属性设置为 true 或 false 来管理启用何种约束以供识别操作。默认设置为 true。

通常，相比为每次识别操作加载、卸载和编译约束，加载一次约束并按需启用或禁用它们更有效率。按照需要使用 IsEnabled 属性。

限制约束数量可以限制语音识别器针对语音输入进行搜索和匹配所需的数据量。这既可以提高性能，又可以增加语音识别的准确性。

根据应用在当前识别操作的上下文中预期的短语，决定启用哪些约束。例如，如果当前的应用上下文是显示一种颜色，那么你可能无需启用识别动物名称的约束。

相关主题

设计人员