除了系统集成的可以用于搜索、启动应用程序等语音命令外,在我们的应用程序内部还能自己定义语音指令,使得我们的APP能与语音操控结合得更加完全。
语音指令是通过一个XML文件来定义的。比如,咱小舅子开了家饭店,并取了一个非常雅致的名字——牛逼饭店,因店里的牛肉烧得特特好吃,连皇帝吃了也舍不得回金銮殿。
为了实现“牛逼饭店”应用能实现语音点菜,在“解决方案资源管理器”窗口中找到应用项目,右击项目名,从快捷菜单中依次执行【添加】【新建项】,在新建项对话框中选中“语音命令定义”。
然后输入文件的名字,确定完成语音命令文件添加。
设置这个文件的生成行为为“内容”,“如果较新则复制”。
下面看一下我为牛逼饭殿定义的语音指令。
<VoiceCommands xmlns="http://schemas.microsoft.com/voicecommands/1.0">
<CommandSet xml:lang="zh-CN">
<CommandPrefix>牛逼饭店</CommandPrefix>
<Example> 饭店主页、我要牛肉、我点白菜 </Example> <Command Name="点菜">
<Example> 我要豆腐,或 我点白菜 </Example>
<ListenFor> 我要{items} </ListenFor>
<ListenFor> 我点{items} </ListenFor>
<Feedback> 好,点菜去 </Feedback>
<Navigate Target="diancai.xaml"/>
</Command> <Command Name="主页">
<Example> 饭店主页 </Example>
<ListenFor> 饭店主页 </ListenFor>
<Feedback> 主页快到了 </Feedback>
<Navigate Target="MainPage.xaml" />
</Command> <PhraseList Label="items">
<Item> 牛肉 </Item>
<Item> 豆腐干 </Item>
<Item> 白菜 </Item>
<Item >火腿</Item>
</PhraseList> </CommandSet>
</VoiceCommands>
这个文件并不复杂,弄清楚其结构就好。
1、根节点为VoiceCommands,并且xmlns必须为http://schemas.microsoft.com/voicecommands/1.0;
2、VoiceCommands下可以包含多个CommandSet节点,每个CommandSet节点表示一个命令集,通常一个命令集表示一种语言,如为英文定义一个命令集,为中文也定义一个。通过xml:lang特性来指定语言,xml:lang="zh-CN"表示语音指令集为中文;
3、CommandPrefix节点是可选的,是CommandSet的子级,只能有一个。别小看CommandPrefix节点,它的作用大得很,如果应用的名字为“牛逼饭店v3.0.0.11”,这样我们朗读起来很痛苦,系统也未必能识别,这时候,如果通过CommandPrefix元素定义一个别名,如<CommandPrefix>牛逼饭店</CommandPrefix>,只要我们对着手机话筒大声说出“牛逼饭店”,系统就会找到牛逼饭店v3.0.0.11应用程序了,知道了吧,这就是CommandPrefix的用途。
4、Example在CommandSet和子Command元素中都能包含;在CommandSet中使用,用于说明整个命令集的操作方法,如果用在Command中,就用于单个命令的示例,示例是用来告诉用户,对着手机应该如何表白。
5、CommandSet下面可以放多个Command元素,表示单个命令。记得要通过Name特性为指令命名,而且在当前命令集中,不要出现相同的命令。命令中可以有Example元素,告诉用户如何使用语音操作。可以包含多个ListenFor元素,该元素表示语音识别系统应当注意聆这些话,比如牛逼饭店中,点菜命令的一个ListenFor为“我要{items}”,即语音系统会注意听“我要大白菜”,“我要豆腐渣”等语句,{items}是啥,后面会说到。
6、Feedback元素是指当语音系统听出命令后的回应,比如我说“我要吃西瓜”,系统识别成功后会返馈一句“西瓜多得是,随便啃。”,如牛逼饭店应用中的<Feedback> 好,点菜去 </Feedback>,当识别成功后,系统会发出一句“好,点菜去”。
7、Navigate元素表示当命令识别成功后,应导航到哪个页面并传递参数。
8、CommandSet中可包含多个PhraseList,PhraseList元素用来定义一组短语,比如上面我们提到“我要{items}”,这个items用一对大括号包起来,表示它是一个占位符,一个标签,它是用下面这个短语列表中的词来替换。
<PhraseList Label="items">
<Item> 牛肉 </Item>
<Item> 豆腐干 </Item>
<Item> 白菜 </Item>
<Item >火腿</Item>
</PhraseList>
一定要注意Label一定要与前面{}中的内容匹配,假如我说“我要白菜”,那么听到的命令就是“我要{items}”,而其中的{items}就会被“白菜”所替代。
现在,大家对语音命令的定义应该了解了,牛逼饭店的示例代码我待会上传。
下面给大家演示一个叫“我的情书榜”的应用程序。
1、启动可爱的VS环境,新建一个WP项目(暂用WP8)。
2、在主页MainPage.xaml中输入以下XAML:
<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
<TextBlock Text="欢迎,欢迎,热烈欢迎。"
FontSize="55" TextWrapping="Wrap"/>
</Grid>
3、再向项目添加一个新页面,名为Write.xaml,XAML如下:
<!--LayoutRoot 是包含所有页面内容的根网格-->
<Grid x:Name="LayoutRoot" Background="Transparent">
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="*"/>
</Grid.RowDefinitions> <!--TitlePanel 包含应用程序的名称和页标题-->
<StackPanel Grid.Row="0" Margin="12,17,0,28">
<TextBlock Text="我的应用程序" Style="{StaticResource PhoneTextNormalStyle}"/>
<TextBlock Text="新情书" Margin="9,-7,0,0" Style="{StaticResource PhoneTextTitle1Style}"/>
</StackPanel> <!--ContentPanel - 在此处放置其他内容-->
<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
<Grid.RowDefinitions>
<RowDefinition Height="Auto"/>
<RowDefinition Height="*"/>
</Grid.RowDefinitions>
<TextBlock Grid.Row="0" FontSize="35" Text="请输入内容:"/>
<TextBox Grid.Row="1" Margin="0,15,0,5"/>
</Grid>
</Grid>
4、现在,向项目中添加一个语音指令定义文件,命名为cmd.xml。注意要把文件的生成操作设置为“内容”,复制到输出目录设置为“如果较新则复制”。并把文件中工具生成的内容删掉,我们自己写一个语音指令定义集。
<?xml version="1.0" encoding="utf-8"?>
<VoiceCommands xmlns="http://schemas.microsoft.com/voicecommands/1.0">
<CommandSet xml:lang="zh-cn">
<CommandPrefix>情书</CommandPrefix>
<Example>情书,或者 写情书。</Example>
<Command Name="write">
<Example>写情书</Example>
<ListenFor>写情书</ListenFor>
<ListenFor>新情书</ListenFor>
<Feedback>去,勇敢地写。</Feedback>
<Navigate Target="Write.xaml"/>
</Command>
<Command Name="main">
<Example>进主页,或 去主页</Example>
<ListenFor>去主页</ListenFor>
<ListenFor>进主页</ListenFor>
<Feedback>欢迎,欢迎。</Feedback>
<Navigate Target="MainPage.xaml"/>
</Command>
</CommandSet>
</VoiceCommands>
为了方便用户说出应用的名字,CommandPrefix指定为“情书”,这样,说出“情书”就可以识别出当前应用。命令集包含两个命令,第一个命令会启动Write.xaml页面,第二个则进入主页。
5、命令文件虽然定义好了,但现在它还不能起作用,需要在运行时安装命令,方法是在App的Launching事件中加入以下代码:
private async void Application_Launching(object sender, LaunchingEventArgs e)
{
await Windows.Phone.Speech.VoiceCommands.VoiceCommandService.InstallCommandSetsFromFileAsync(new Uri("ms-appx:///cmd.xml"));
}
现在,运行应用程序,然后激活系统语音帮助(长按Win键),这时候,语音助手启动,点击右上角的问题,如下图所示。
切换到“应用程序”页,然后会看到我们的应用程序,点击它。
这时候,会看到一些提示的示例文本,大家细心研究就会看到,这些示例文本就是我们在Example节点中定义的文本。
现在你对着手机喊“情书 写情书”,识别后会启动应用程序,然后跳转到Write.xaml页面。
在通过语音操作进入页面时会向页面传递参数,参数包含命令的名字、已识别的内容,可以在页面的OnNavigatedTo方法中处理,具体大家可以参考我上传的牛逼饭店应用。
牛逼饭店示例下载地址:http://files.cnblogs.com/tcjiaan/%E7%89%9B%E9%80%BC%E9%A5%AD%E5%BA%97.rar
怎么样,动手试试吧。
============================================
【后话】
WP 8.1中对应的命名空间在Windows.Media.SpeechRecognition。
安装语音指令文件,使用VoiceCommandManager类的静态方法InstallCommandSetsFromStorageFileAsync,不过要注意该方法的参数是StorageFile对象,而SL for WP中是URI的,同样,可以通过GetFileFromApplicationUriAsync方法来从URI得到文件引用。
var file = await Windows.Storage.StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appx:///cmd.xml"));
await Windows.Media.SpeechRecognition.VoiceCommandManager.InstallCommandSetsFromStorageFileAsync(file);