导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

Windows Phone 8 的语音命令元素和特性引用

2014/6/18

仅适用于:Windows Phone 8 和 Windows Phone Silverlight 8.1

下表介绍语音命令定义文件的元素和特性。

元素

描述

VoiceCommands

语音命令清单必需的根元素。它的 xmlns 特性值必须为 http://schemas.microsoft.com/voicecommands/1.0(无大写字符)。包含一个或多个 CommandSet 元素,分别代表一种语言的语音命令。

CommandSet

VoiceCommands 元素必需的子元素。针对所有语音命令的容器,应用将在必需的 xml:lang 特性所指定的单个语言中接受它。xml:lang 特性的值在 VoiceCommand 文档中必须是独一无二的。Name 特性可选,而且可以是任意字符串;但是为了以编程方式引用和更新 CommandSet 元素的 PhraseList,Name 特性则是必需的。CommandSet 元素包含以下子元素:CommandPrefix(0 或 1 个)、示例(仅 1 个)、命令(1 至 100 个)和 PhraseList 元素(0 或更多个)。这些子元素必须按所列顺序出现。

CommandPrefix

VoiceCommands 元素的可选子元素。如果存在,则必须是 CommandSet 元素的第一个子元素。为应用指定用户友好名称,用户在发出语音命令时可以说出它。这对于名称较长或较难发音的应用有用。

命令

CommandSet 元素的必需子元素。采用 Name 特性。定义用户可以通过说话发起的应用操作以及可以发起该操作的说话内容。每一个命令元素都与应用中的特定页面关联。示例(仅 1 个)、ListenFor(最多 10 个)、反馈(仅 1 个)和导航(仅 1 个)。这些子元素必须按所列顺序出现。

示例

命令元素的必需子元素,CommandSet 元素的可选子元素。展示用户如何说出命令的理想示例。

作为 CommandSet 元素的子元素,示例文本在以下屏幕中显示:

  • “我可以说什么”屏幕的“应用”页面上的应用名称下面。该页列出包含增强的语音命令的所有应用。

  • “我可以说什么”屏幕的“打开”页面上,将有应用名称 + 示例文本的两个附加示例,它们链接至“应用”页面。

  • 在一些错误屏幕上。

  • “侦听”屏幕上。

  • 在列出应用命令的“您知道吗”帮助屏幕上。

ListenFor

命令元素的必需子元素。包含应用将识别为该命令的单词或短语。这可能包括或可能是对 PhraseList 元素的 Label 特性的引用,它在 ListenFor 元素中出现,括在大括号中,例如: 命令元素可包含最多 10 个 ListenFor 元素,其中任一元素的内容被识别出后即可激活该命令。

对可选单词使用括号。这意味着,可以说该单词或这些单词,但它(们)不一定有匹配。您可以通过在一对大括号中包含星号字符设置通配符功能,例如 <ListenFor>Find {*}</ListenFor>。在此示例中,只要用户说出“查找”后跟任意其他单词或短语,语音命令将进行匹配。如果启用通配符的 ListenFor 元素的语音命令得到匹配,则 reco 密钥将包含字符串“…”。

反馈

命令元素的必需子元素。指定当命令被识别时,将显示并向用户读回的文本。如果反馈元素包含对 PhraseList 元素的引用,那么包含的命令元素中的每一个 ListenFor 元素也必须引用相同的 PhraseList。

导航

命令元素的必需子元素。

您可以指定 Target 特性,该特性指定应用启动时必须加载的页面。如果指定了 Target 特性,还可以添加您自己的查询参数。如果没有指定 Target 特性,应用启动至其主页面。

以下 XML 代码演示如何设置具有 Target 特性和自定义查询参数的导航元素:

<Navigate Target="Page2.xaml?myParam=someValue"/>

PhraseList

CommandSet 元素的可选子元素。必须具有 Label 特性,该特性的值用大括号括在 ListenFor 或反馈元素中,用于引用 PhraseList。

可选择地指定 Disambiguate 特性(默认值为 true),它控制来自该 PhraseList 元素的内容是否将使用户消除歧义,进而将识别结果发出为查询字符串参数,用于引用语音命令。

包含最多 2,000 个的项元素,每一个元素指定可以被识别出用以发起引用了 PhraseList 的命令的单词或短语。2,000 个的项元素限制是涵盖 CommandSet 中所有 PhraseList 元素的总量。

PhraseList 元素的可选子元素。可被识别以发起命令的多个单词或短语中的一个。CommandSet 在其所有 PhraseList 元素范围内可包含不超过 2,000 个项元素。

您可使用以下特殊字符定义命令。

重要说明重要说明:

不能嵌套以下所列的特殊字符。例如,诸如 [[start] new game][{myPhraseList}] 之类的语句不可用。

特殊字符

描述

{}

包含 PhraseList 可引用的 Label 特性的值,例如 {myPhraseList}。在 ListenFor 或反馈元素内使用。反馈元素中的 PhraseList 引用必须与相同命令中的 ListenFor 元素中的相应引用匹配。

[]

指定被括起的单词或短语为可选。可以说被括起的单词或短语,但不需要识别它来发起命令。例如,如果 ListenFor 元素的内容是“[启动][开始]新游戏”,用户可以通过说“启动新游戏”或“新游戏”或“开始新游戏”(甚至“启动开始新游戏”)来发起命令。

每一个被括起的元素都独立可选,但必须按正确的顺序说出,它们才能被识别。因此,在“新游戏”示例中,可以说“启动开始新游戏”,但不可以说“开始启动新游戏”,这是因为它们被声明的顺序的缘故。

显示:
© 2014 Microsoft