原文:在UWP应用中加入Cortana语音指令集
本文介绍小娜语音指令集的使用场景，如何将UWP应用接入小娜的语音指令集，使用户直接通过小娜启动应用并使用应用中 一些轻量级的功能。文中以必应词典作为实例讲解必应词典UWP版本是如何接入小娜语音功能的。
小娜算得上是Windows 10一大卖点，跟邻居家的Google Now和Siri比起来叫好声也更多。除了经典开始菜单的“回归”，UWP通用应用架构，营销人员口中三句话不离的，自然还有微软小娜。其实微软小娜是具有第三方应用整合能力的，而且隐隐可见微软让小娜平台化的意图，所以小娜的入口自然也就成了开发者的兵家必整之地了。
使用情景
目前小娜开放给第三方应用的接口主要是语音指令集（Voice Command Definitions）。
现来看看VCD到底能做些什么。VCD的使用场景概括说来有两种：
第一种是利用第三方应用本身的数据能力，在用户输入语音指令或文字指令后，在小娜的界面内显示由第三方应用提供的一些数据，完成一些轻量级功能。比如提供一些文字、信息。
第二种是将用户输入的语音指令或文字中的信息，作为第三方应用的启动参数，在应用打开后直接跳转到相应的功能页面，缩短导航的路径长度。比如对小娜说“在大众点评中查找附近吃烤鱼的饭馆”，小娜将会打开大众点评，直接跳转到能吃烤鱼的附近的餐厅。这里小娜为用户省去了打开应用，打开查找页，搜索附近吃烤鱼的餐厅这几步。
在新版本的必应词典中，主要用到的是第一种情景。我们先来看一看整个体验长啥样：
用户对着小娜说：“必应词典，告诉我cute是什么意思？” 小娜理解以后跟必应词典沟通，取回cute的意思，并显示出来
开发实现
要实现这些，有两个关键部分，第一个是定义语法。
小娜VCD的语法文件是一个xml格式的文件。先来看看官方的文档以及官文的实例代码：
https://msdn.microsoft.com/en-us/library/windows/apps/dn706593.aspx
https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/CortanaVoiceCommand
我在这里重点介绍必应词典的VCD实现。下面是必应词典VCD的语法文件：
<?xml version="1.0" encoding="utf-8" ?>
<VoiceCommands xmlns="http://schemas.microsoft.com/voicecommands/1.2">
<CommandSet xml:lang="zh-hans-cn" Name="DictCommandSet_zh-cn">
<AppName> 必应词典 </AppName>
<Example> 翻译一下 friend </Example>
<Command Name="searchWord">
<Example> 翻译一下 friend </Example>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}[告诉我]{query}的意思 </ListenFor>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}[告诉我]{query}[是]什么意思 </ListenFor>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}{query}[用][英语][英文]怎么说 </ListenFor>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}[英语][英文]{query}怎么说 </ListenFor>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}{query}用[汉语][中文]怎么说 </ListenFor>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}什么是{query}</ListenFor>
<Feedback>正在查询{query}的释义...</Feedback>
<VoiceCommandService Target="DictVoiceCommandService"/>
</Command>
<Command Name="translate">
<Example> 翻译一下 friend</Example>
<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}翻译[一下][单词]{query}</ListenFor>
<Feedback>正在翻译{query}...</Feedback>
<VoiceCommandService Target="DictVoiceCommandService"/>
</Command>
<PhraseTopic Label="query" Scenario="Search">
<Subject> Words </Subject>
</PhraseTopic>
</CommandSet>
</VoiceCommands>
VCD中的语法是区分语言的，每个Cortana语言，都是一个CommandSet。对于中文来说，是zh-CN或zh-hans-CN。每一个CommandSet要求一个AppName。理论上这个AppName的名称是可以自定义的，未必非要与应用一模一样。比如我们的应用全名叫“必应词典Win10版”，如果用户需要说：“必应词典Win10版告诉我cute是什么意思？”估计用户会崩溃。不过取应用名的时候还是要稍微讲究一点，一来是用户用着方便，二来如果名字起得太常见可能会跟其它应用产生歧义，也可能有因为破坏了小娜自身的一些功能而被用户卸载的风险。
在ListenFor语句中，[]表示可选字，{}表示特殊字。一句ListenFor中，不能全部由可选字组成，否则就像正则表达式中的.或*一样，无法匹配了。{builtin:AppName} 是应用名字出现的位置，应用的名字可以出现在一句话的开头，也可以在其它位置。
例如：<ListenFor RequireAppName="ExplicitlySpecified"> {builtin:AppName}{query}[用][英语][英文]怎么说 </ListenFor>
对于这 句语法，“必应词典xxx怎么说”，“必应词典xxx用英语怎么说”，“必应词典xxx用英文怎么说”，“必应词典xxx英语怎么说”，等等都是可识别的。
正如msdn所述，PhraseTopic可表示任意词，subject和scenario用来辅助语言识别模型更准确的识别语音输入。枚举类型可以通过msdn查到。
在应用的App.xaml.cs文件中，需要把写好的文件在应用启动时装载进Cortana。
protected async override void OnLaunched(LaunchActivatedEventArgs e)
{
…
InstallVoiceCommand();
…
}
private async Task InstallVoiceCommand()
{
try
{
//user can stop VCD in settings
if (AppSettings.GetInstance().CortanaVCDEnableStatus == false)
return;
// Install the main VCD. Since there's no simple way to test that the VCD has been imported, or that it's your most recent
// version, it's not unreasonable to do this upon app load.
StorageFile vcdStorageFile = await Package.Current.InstalledLocation.GetFileAsync(@"DictVoiceCommands.xml");
await Windows.ApplicationModel.VoiceCommands.VoiceCommandDefinitionManager.InstallCommandDefinitionsFromStorageFileAsync(vcdStorageFile);
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine("Installing Voice Commands Failed: " + ex.ToString());
}
}
第二个重要的部分是语音应用服务(app service)
仿照msdn的sample，必应词典也在解决方案中建立了一个BingDictUWP.VoiceCommands工程。需要注意的是，这个工程的output type必须是Windows Runtime Component。否则backgroundtask将不工作。如下图：
对于backgroundtask这个项目，大家仍然可以从github上下载刚才分享的链接里的项目。大体框架可以直接用那个sample，自己在相应位置做一些修改。
以下是必应词典用来处理小娜发回的语音指令的代码
namespace BingDictUWP.AppExtensions
{
/// <summary>
/// The VoiceCommandService implements the entrypoint for all headless voice commands
/// invoked via Cortana. The individual commands supported are described in the
/// AdventureworksCommands.xml VCD file in the AdventureWorks project. The service
/// entrypoint is defined in the Package Manifest (See section uap:Extension in
/// AdventureWorks:Package.appxmanifest)
/// </summary>
public sealed class DictVoiceCommandService : IBackgroundTask
{
...
/// <summary>
/// Background task entrypoint. Voice Commands using the <VoiceCommandService Target="...">
/// tag will invoke this when they are recognized by Cortana, passing along details of the
/// invocation.
///
/// Background tasks must respond to activation by Cortana within 0.5 seconds, and must
/// report progress to Cortana every 5 seconds (unless Cortana is waiting for user
/// input). There is no execution time limit on the background task managed by Cortana,
/// but developers should use plmdebug (https://msdn.microsoft.com/en-us/library/windows/hardware/jj680085%28v=vs.85%29.aspx)
/// on the Cortana app package in order to prevent Cortana timing out the task during
/// debugging.
///
/// Cortana dismisses its UI if it loses focus. This will cause it to terminate the background
/// task, even if the background task is being debugged. Use of Remote Debugging is recommended
/// in order to debug background task behaviors. In order to debug background tasks, open the
/// project properties for the app package (not the background task project), and enable
/// Debug -> "Do not launch, but debug my code when it starts". Alternatively, add a long
/// initial progress screen, and attach to the background task process while it executes.
/// </summary>
/// <param name="taskInstance">Connection to the hosting background service process.</param>
public async void Run(IBackgroundTaskInstance taskInstance)
{
mServiceDeferral = taskInstance.GetDeferral();
// Register to receive an event if Cortana dismisses the background task. This will
// occur if the task takes too long to respond, or if Cortana's UI is dismissed.
// Any pending operations should be cancelled or waited on to clean up where possible.
taskInstance.Canceled += OnTaskCanceled;
var triggerDetails = taskInstance.TriggerDetails as AppServiceTriggerDetails;
// Load localized resources for strings sent to Cortana to be displayed to the user.
mCortanaResourceMap = ResourceManager.Current.MainResourceMap.GetSubtree("Resources");
// Select the system language, which is what Cortana should be running as.
mCortanaContext = ResourceContext.GetForViewIndependentUse();
var lang = Windows.Media.SpeechRecognition.SpeechRecognizer.SystemSpeechLanguage.LanguageTag;
mCortanaContext.Languages = new string[] { Windows.Media.SpeechRecognition.SpeechRecognizer.SystemSpeechLanguage.LanguageTag };
// Get the currently used system date format
mDateFormatInfo = CultureInfo.CurrentCulture.DateTimeFormat;
// This should match the uap:AppService and VoiceCommandService references from the
// package manifest and VCD files, respectively. Make sure we've been launched by
// a Cortana Voice Command.
if ((triggerDetails != null) && (triggerDetails.Name == "DictVoiceCommandService"))
{
try
{
mVoiceServiceConnection = VoiceCommandServiceConnection.FromAppServiceTriggerDetails(triggerDetails);
mVoiceServiceConnection.VoiceCommandCompleted += OnVoiceCommandCompleted;
VoiceCommand voiceCommand = await mVoiceServiceConnection.GetVoiceCommandAsync();
//var properties = voiceCommand.SpeechRecognitionResult.SemanticInterpretation.Properties.Values.First()[0];
// Depending on the operation (defined in AdventureWorks:AdventureWorksCommands.xml)
// perform the appropriate command.
switch (voiceCommand.CommandName)
{
case "searchWord":
case "translate":
var keyword = voiceCommand.Properties["query"][0];
await SendCompletionMessageForKeyword(keyword);
break;
}
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine("Handling Voice Command failed " + ex.ToString());
}
}
}
…}
大家需要在Package.appxmanifest里声名App Service并正确填写该service的entry point，如下图：
写在最后
关于Cortana语音指令集，目前还存在一些可以改进的地方，比如语音指令集的语法全靠手写，并没有自然语音理解的能力。如果开发者在使用中还有其它痛点，也欢迎给我们留言一起讨论。说不定这些痛点，下个版本就能解决了呢 :)