上篇文章中介绍了(53078485群)大咖Aran的博客:Win10/UWP开发—使用Cortana语音指令启动前台App ;而这篇博客我们将接着上篇文章的内容为大家带来大咖Aran的讲解:讲讲如何使用Cortana调用App的后台任务。
//------------------------------------------------------
//
// FileName: XiaoMiTask.cs
// Namespace: XiaoMiBackgroundTask
// Assembly: XiaoMiBackgroundTask
// Description:
// Author: aran_wang
// Created On: 2015-09-10
//------------------------------------------------------
using System;
using System.Collections.Generic;
using System.Diagnostics;
using System.Threading.Tasks;
using Windows.ApplicationModel.AppService;
using Windows.ApplicationModel.Background;
using Windows.ApplicationModel.VoiceCommands;
using Windows.Storage;
namespace XiaoMiBackgroundTask
{
/*
VoiceCommandServiceConnection 类是接受Cortana传递过来的信息以及给Cortana回应信息的
里面有几个重要的方法:
GetVoiceCommandAsync 检索用户的语音命令提交Cortana通过语音或文本。
ReportFailureAsync 发送一个响应,表明Cortana语音命令处理失败了。
ReportProgressAsync 发送一个响应,Cortana在处理语音命令。
ReportSuccessAsync 发送一个响应,Cortana语音命令已成功了。
RequestAppLaunchAsync 发送一个响应,要求Cortana启动前台应用
RequestConfirmationAsync 发送一个响应,指示Cortana语音命令需要确认。
RequestDisambiguationAsync 发送一个响应,表示Cortana语音命令返回多个结果,需要用户选择一个。
*/
public sealed class XiaoMiTask : IBackgroundTask
{
BackgroundTaskDeferral _taskDerral;
VoiceCommandServiceConnection _serviceConnection;
public async void Run(IBackgroundTaskInstance taskInstance)
{
_taskDerral = taskInstance.GetDeferral();
var details = taskInstance.TriggerDetails as AppServiceTriggerDetails;
// 验证是否调用了正确的app service
if (details == null || details.Name != "XiaoMiService")
{
_taskDerral.Complete();
return;
}
_serviceConnection = VoiceCommandServiceConnection.FromAppServiceTriggerDetails(details);
// 获取被识别的语音命令
var cmd = await _serviceConnection.GetVoiceCommandAsync();
switch (cmd.CommandName)
{
case "QueryTrain":
var date = cmd.Properties["DateTime"][0];
var from = cmd.Properties["From"][0];
var to = cmd.Properties["To"][0];
await QueryTrain(date, from, to);
break;
case "CancelTrain":
var cancelTrain = cmd.Properties["City"][0];
CancelTrain(cancelTrain);
break;
}
_taskDerral.Complete();
}
private void CancelTrain(string cancelTrain)
{
//取消火车 交互类似
Debug.WriteLine(cancelTrain);
}
private async Task QueryTrain(string date, string from, string to)
{
// msgback是返回给Cortana 要显示的内容
var msgback = new VoiceCommandUserMessage();
// msgRepeat是指当cortana对用户语音指令不明确的时候显示的,一般用来消除用户歧义
// 比如存在让用户选择某个选项时,用户没有按照预期的操作方式去操作,cortana会显示第二消息来告诉一些操作提示信息
var msgRepeat = new VoiceCommandUserMessage();
//模拟火车列表,真实情况下需要调用api获取火车信息
var trainList = new List();
for (var i = 0; i < 6; i++)
{
trainList.Add(new VoiceCommandContentTile
{
AppContext = i, //用来存储该条Tile的标识 一般存储数据id
ContentTileType = VoiceCommandContentTileType.TitleWith68x68IconAndText,
Image = await StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appx:///Images/300300.jpg")),
Title = $"D{i + 3}8{i * 2}",
TextLine1 = $"出发:{DateTime.Now.AddHours(i)} - 到达:{DateTime.Now.AddHours(i + 2)}"
});
}
TrainList:
msgback.DisplayMessage = msgback.SpokenMessage = $"我找到了{date}从{from}到{to}的火车列表,请选择:";
msgRepeat.DisplayMessage = msgRepeat.SpokenMessage = "你要告诉我你想预定哪个车次的火车:";
// 把查询到的火车列表发回到Cortana ,注意 列表最多显示10个
var response = VoiceCommandResponse.CreateResponseForPrompt(msgback, msgRepeat, trainList);
// 用户选择了哪个项
var selectedRes = await _serviceConnection.RequestDisambiguationAsync(response);
//创建咨询用户是否确定要预定该车次的信息
msgback.DisplayMessage = msgback.SpokenMessage = $"您确定要预定 {selectedRes.SelectedItem.Title} 次列车吗?";
msgRepeat.DisplayMessage = msgRepeat.SpokenMessage = "请选择是或者不是";
response = VoiceCommandResponse.CreateResponseForPrompt(msgback, msgRepeat);
//返回让用户选择 是 或者 不是 的信息给cortana
var result = await _serviceConnection.RequestConfirmationAsync(response);
//如果用户选择是
if (result.Confirmed)
{
//提示预定成功
msgback.DisplayMessage = msgback.SpokenMessage = $"您成功预定了 {selectedRes.SelectedItem.Title} 次列车,{date}从{from}到{date},{selectedRes.SelectedItem.TextLine1}!";
msgRepeat.DisplayMessage = msgRepeat.SpokenMessage = $"您成功预定了 {selectedRes.SelectedItem.Title} 次列车。";
response = VoiceCommandResponse.CreateResponseForPrompt(msgback, msgRepeat);
}
else
{
goto TrainList;
}
// 返回一个操作成功的指令
await _serviceConnection.ReportSuccessAsync(response);
}
}
}
注册App后台服务
查询去某地的火车
查询{DateTime}从{From}到{To}的火车
正在查询{DateTime}从{From}到{To}的火车
取消去某地的火车
取消去{City}的火车
正取消去{City}的火车
City/State
City/State
City/State
Date/Time
注册VCD文件
///
/// 注册语音指令
///
private async Task InsertVoiceCommands()
{
await VoiceCommandDefinitionManager.InstallCommandDefinitionsFromStorageFileAsync(
await StorageFile.GetFileFromApplicationUriAsync(new Uri("ms-appx:///VoiceCommandsFile.xml")));
}