【Win 10 应用开发】启动远程设备上的应用

时间:2022-12-28 03:12:57

这个功能必须在“红石-1”(build 14393)以上的系统版中才能使用,运行在一台设备上的应用,可以通过URI来启动另一台设备上的应用。激活远程应用需要以下前提:

  • 系统必须是build 14393或以上版本,UWP应用必须使用14393或以上版本的SDK开发。
  • 被启动的应用应当支持协议激活,比如Cortana的协议URI为:【ms-cortana:】,当然如果是你自己开发的应用,可以自己定义一个协议,名字随便取,不要跟系统的协议或别人的应用冲突就行,比如:【haha:】【zxzx:】等。
  • 必须用同一个Microsoft帐号登录的设备。即同一个MS帐号登录的设备才可以。这个功能得保证一定的安全性,肯定不能让你随便什么设备都能连,那应用就成了木马了。

设置种类没有限制,只要运行“红石”或以上的Windows 10系统就行,包括PC、平板、Hub、手机、xBox、笔记本、Iot、全息虚拟化设备……如果是虚拟机里面装的系统,用MS帐号登录就可以了,只要是Win 10,管你什么设备,都可以耍。

是不是很高大上,下面老周就说说怎么耍,老规矩,还是先来了解一下方法。

我们要用到两个命名空间,你要用的类,就从这两个命名空间里面找就行了,一定要学会用“对象浏览器”窗口。

  • Windows.System
  • Windows.System.RemoteSystems

看看名字,Remote System,你都可以猜到七分,肯定和远程调用有关的。

要调用远程设备上的应用,首先得找出这些设备,SDK提供了两种方法来实现。第一种方法比较简单,直接通过设备名来找,调用RemoteSystem.FindByHostNameAsync(HostName)静态方法,指定要查找的设备名,如果找到,就返回一个RemoteSystem实例(可异步等待)。RemoteSystem类封装了远程系统相关的信息,信息量不大,无非就是计算机名,以及一个ID值,这个ID可以用于唯一标识设备。

第二种方法工程量有点大,它是通过创建一个RemoteSystemWatcher对象,然后用这个对象来监视远程设备的连接情况,如果找到设备,会发生RemoteSystemAdded事件,如果某个设备被移除(MS帐号不再登录该设备,并在设备管理网页中移除设备)就会引发RemoteSystemRemoved事件。

要开启监视就调用Start方法,要停止就调用Stop方法。

在创建RemoteSystemWatcher对象时,可以向RemoteSystem.CreateWatcher方法传递若干个过滤器,以确定查找范围。过滤器类都会实现IRemoteSystemFilter接口。

可选的过滤器可以有这些:

  • RemoteSystemKindFilter:按设备类型来过滤,如桌面、手机、xBox等,这个字符串可以从RemoteSystemKinds类的静态属性中获取。
  • RemoteSystemDiscoveryTypeFilter:按发现范围来过滤,规则由RemoteSystemDiscoveryType枚举来定义,Any表示不限制范围,Proximal表示通过内网或蓝牙可以连接的范围来找,Cloud是云端记录的设备,就是用MS帐号登录的设备。当然大提前是这些设备都用MS帐号登录并使用中。
  • RemoteSystemStatusTypeFilter:通过设备的当前状态来过滤,即这个设备当前是否处于可连接状态。

查找到远程设备后,使用RemoteSystem实例创建一个RemoteSystemConnectionRequest实例,因为激活应用的时候要用到。

最后把刚创建的RemoteSystemConnectionRequest实例,连同要启动应用的URI一起传递给RemoteLauncher类的LaunchUriAsync方法就可以启动远程设备上的应用了。

下面,实战一下。

这个示例不复杂,先扫描可用的远程设备(电脑、手机、平板、游戏机通杀),然后选择一个设备,最终启动目标设备上的【计算器】应用。UWP计算器的协议URI为:【calculator:】(不包括【】)。

首先,查找一下设备。

           var reqres = await RemoteSystem.RequestAccessAsync();
if (reqres != RemoteSystemAccessStatus.Allowed)
{
btnLaunch.IsEnabled = false;
return;
} List<IRemoteSystemFilter> filterList = new List<IRemoteSystemFilter>();
RemoteSystemDiscoveryTypeFilter ft1 = new RemoteSystemDiscoveryTypeFilter(RemoteSystemDiscoveryType.Any);
string[] kinds =
{
RemoteSystemKinds.Desktop,
RemoteSystemKinds.Phone,
RemoteSystemKinds.Xbox
};
RemoteSystemKindFilter ft2 = new RemoteSystemKindFilter(kinds);
filterList.Add(ft1);
filterList.Add(ft2); watcher = RemoteSystem.CreateWatcher(filterList);
watcher.RemoteSystemAdded += RemoteSystem_Added;
watcher.RemoteSystemRemoved += RemoteSystem_Removed;
watcher.Start();

注意,在做任何查找操作之前,必须先调用RequestAccessAsync方法,确定系统允许你操作才行,否则是白忙一场。

下面代码处理watcher的两个事件。

        private async void RemoteSystem_Removed(RemoteSystemWatcher sender, RemoteSystemRemovedEventArgs args)
{
await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
RemoteSystem sys = remoteSystems.FirstOrDefault(r => r.Id == args.RemoteSystemId);
if (sys != null)
{
remoteSystems.Remove(sys);
}
});
} private async void RemoteSystem_Added(RemoteSystemWatcher sender, RemoteSystemAddedEventArgs args)
{
await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
{
remoteSystems.Add(args.RemoteSystem);
});
}

现在,可以在选定的设备上启动计算器了。

           if (lv.SelectedIndex == -) return;

            btnLaunch.IsEnabled = false;
RemoteSystem rmsys = lv.SelectedItem as RemoteSystem;
Uri remoteUri = new Uri("calculator:");
RemoteSystemConnectionRequest request = new RemoteSystemConnectionRequest(rmsys);
var r = await RemoteLauncher.LaunchUriAsync(request, remoteUri);
btnLaunch.IsEnabled = true;

还有很关键一步,就是配置清单文件,如果不配置,是没有权限的。

支持远程系统的设备功能是在版本3的XML命名空间中声明的,所以要先引入。

xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"

给它一个前缀叫uap3,后面方便引用。然后声明相关的Capability。

<Capabilities>
<Capability Name="internetClient" />
<uap3:Capability Name="remoteSystem" />
</Capabilities>

好了,一切都准备好了,先启动另一台设备(或者虚拟机中的系统)。

然后回到开发机,运行应用,它会查找到你登录过的设备。

【Win 10 应用开发】启动远程设备上的应用

在列表中选择一台设备,再点下面的按钮,如果没有发生自然灾害的话,你的另一台设备上的【计算器】应用就会启动。如下图。

【Win 10 应用开发】启动远程设备上的应用

好了,今天的话题就讨论到这里吧。

示例代码下载地址