1# 分布式远程启动<a name="ZH-CN_TOPIC_0000001051071561"></a> 2 3## 概述<a name="section186634310418"></a> 4 5分布式任务调度模块，通过主从设备服务代理机制，在OpenHarmony操作系统上建立起分布式服务平台，支持主设备\(搭载OpenHarmony的智慧屏设备\)启动从设备\(IP Camera、运动手表等小内存OpenHarmony设备\)FA的能力。 6 7以智慧屏节目开播提醒为例，智慧屏上在喜欢的节目菜单中，点击“开播后提醒我”按钮，等节目开播后，智慧屏会拉起运动手表上的节目开播提醒FA。通过该FA用户可以快速知道喜欢的节目已经开始，达到协同互助的作用。 8 9## 基本概念<a name="section982651246"></a> 10 11- FA 12 13 Feature Ability代表有界面的Ability，用于与用户进行交互。 14 15 16- 远程启动 17 18 即跨设备启动FA，与本地启动FA相对应。 19 20 21## 接口说明<a name="section125479541744"></a> 22 23智慧屏端分布式开放能力如下表，包含在AbilitySlice类中，具体的API接口详见OpenHarmony应用接入接口文档： 24 25**表 1** 分布式远程启动FA的API接口功能介绍 26 27<a name="table1731550155318"></a> 28<table><thead align="left"><tr id="row4419501537"><th class="cellrowborder" valign="top" width="57.38999999999999%" id="mcps1.2.3.1.1"><p id="p54150165315"><a name="p54150165315"></a><a name="p54150165315"></a>接口名</p> 29</th> 30<th class="cellrowborder" valign="top" width="42.61%" id="mcps1.2.3.1.2"><p id="p941150145313"><a name="p941150145313"></a><a name="p941150145313"></a>描述</p> 31</th> 32</tr> 33</thead> 34<tbody><tr id="row34145016535"><td class="cellrowborder" valign="top" width="57.38999999999999%" headers="mcps1.2.3.1.1 "><p id="p1682733119213"><a name="p1682733119213"></a><a name="p1682733119213"></a>void startAbility(Want want)</p> 35</td> 36<td class="cellrowborder" valign="top" width="42.61%" headers="mcps1.2.3.1.2 "><p id="p13562171015712"><a name="p13562171015712"></a><a name="p13562171015712"></a>远程启动FA，Want参数命名以实际开发平台API为准。</p> 37</td> 38</tr> 39</tbody> 40</table> 41 42**表 2** 参数Want功能介绍 43 44<a name="table02120432364"></a> 45<table><thead align="left"><tr id="row172294315361"><th class="cellrowborder" valign="top" width="5.780578057805781%" id="mcps1.2.4.1.1"><p id="p722144318360"><a name="p722144318360"></a><a name="p722144318360"></a>参数名</p> 46</th> 47<th class="cellrowborder" valign="top" width="29.322932293229325%" id="mcps1.2.4.1.2"><p id="p10227434363"><a name="p10227434363"></a><a name="p10227434363"></a>类型</p> 48</th> 49<th class="cellrowborder" valign="top" width="64.89648964896489%" id="mcps1.2.4.1.3"><p id="p22284383616"><a name="p22284383616"></a><a name="p22284383616"></a>说明</p> 50</th> 51</tr> 52</thead> 53<tbody><tr id="row3228436365"><td class="cellrowborder" valign="top" width="5.780578057805781%" headers="mcps1.2.4.1.1 "><p id="p1391227193713"><a name="p1391227193713"></a><a name="p1391227193713"></a>want</p> 54</td> 55<td class="cellrowborder" valign="top" width="29.322932293229325%" headers="mcps1.2.4.1.2 "><p id="p20993611193719"><a name="p20993611193719"></a><a name="p20993611193719"></a>ohos.aafwk.content.Want</p> 56</td> 57<td class="cellrowborder" valign="top" width="64.89648964896489%" headers="mcps1.2.4.1.3 "><p id="p10555172211377"><a name="p10555172211377"></a><a name="p10555172211377"></a>当开发者需要调用该接口启动远程FA时，需要显式指定待启动FA的设备id、bundleName和abilityName。</p> 58</td> 59</tr> 60</tbody> 61</table> 62 63## 约束与限制<a name="section1165911177314"></a> 64 65- 支持主设备侧远程启动从设备侧FA，不支持从设备远程启动主设备FA。 66- 远程启动前必须确保OpenHarmony设备间分布式组网成功（需要在同一网段内，可互相ping通），否则无法远程启动。 67- 当前只支持拥有共同公钥信息的主从设备间FA（即主从设备的FA使用相同华为证书）的拉起。 68 69## 开发步骤<a name="section34171333656"></a> 70 71智慧屏侧通过如下操作启动从设备侧FA，从设备侧FA默认已开发。 72 731. 打开DevEco Studio，完成智慧屏侧FA开发。 742. 获取目标在线从设备的设备ID。 75 76 ``` 77 // 引入设备选择头文件 78 import ohos.distributedschedule.interwork.DeviceInfo; 79 import ohos.distributedschedule.interwork.DeviceManager; 80 81 // 获取在线设备列表 82 List<DeviceInfo> deviceInfoListOnline = DeviceManager.getDmsDeviceList(DeviceInfo.FLAG_GET_ONLINE_DEVICE); 83 String remote_device_id; 84 if (deviceInfoListOnline.size() > 0) 85 { 86 remote_device_id = deviceInfoListOnline[0].GetDeviceId(); // 获取在线列表中第一台设备的设备ID 87 } 88 ``` 89 903. 构造want，首先使用ElementName类表明需要启动的远端设备ID，包名，Ability类名，传入want中，然后设置want中的分布式标志位Want.FLAG\_ABILITYSLICE\_MULTI\_DEVICE表示需要远程启动。 91 92 ``` 93 // 引入相关头文件 94 import ohos.aafwk.ability.Ability; 95 import ohos.aafwk.content.Want; 96 import ohos.bundle.ElementName; 97 98 // 启动远程设备FA 99 Want want = new Want(); // 封装启动远端FA的Want 100 // 使用步骤2中获取的设备ID，并指定FA信息 101 ElementName name = new ElementName(remote_device_id, "com.huawei.remote_package_name", "remote_class_name"); 102 want.setElement(name); // 将待启动的FA信息添加到Want中 103 want.setFlags(Want.FLAG_ABILITYSLICE_MULTI_DEVICE); // 设置分布式标记，若不设置将无法使用分布式能力 104 startAbility(want); // 按照Want启动指定FA,Want参数命名以实际开发平台API为准 105 ``` 106 107 108