hop-multi-device-collaboration.md 21.6 KB
Newer Older
Z
zengyawen 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
# 多端协同(仅对系统应用开放)


## 功能描述

多端协同主要包括如下场景:

- [通过跨设备启动UIAbility和ServiceExtensionAbility组件实现多端协同(无返回数据)](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)

- [通过跨设备启动UIAbility组件实现多端协同(获取返回数据)](#通过跨设备启动uiability组件实现多端协同获取返回数据)

- [通过跨设备连接ServiceExtensionAbility组件实现多端协同](#通过跨设备连接serviceextensionability组件实现多端协同)

- [通过跨设备Call调用实现多端协同](#通过跨设备call调用实现多端协同)


## 多端协同流程

多端协同流程如下图所示。

  **图1** 多端协同流程图  
![hop-multi-device-collaboration](figures/hop-multi-device-collaboration.png)


## 约束限制

- 由于“多端协同任务管理”能力尚未具备,开发者当前只能通过开发系统应用获取设备列表,不支持三方应用接入。

Z
zhongjianfei 已提交
29
- 多端协同需遵循[分布式跨设备组件启动规则](component-startup-rules.md#分布式跨设备组件启动规则)
Z
zengyawen 已提交
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49

- 为了获得最佳体验,使用want传输的数据建议在100KB以下。


## 通过跨设备启动UIAbility和ServiceExtensionAbility组件实现多端协同(无返回数据)

在设备A上通过发起端应用提供的启动按钮,启动设备B上指定的UIAbility。


### 接口说明

  **表1** 跨设备启动API接口功能介绍

| **接口名** | **描述** |
| -------- | -------- |
| startAbility(want: Want, callback: AsyncCallback<void>): void; | 启动UIAbility和ServiceExtensionAbility(callback形式)。 |


### 开发步骤

50
1. 申请`ohos.permission.DISTRIBUTED_DATASYNC`权限,配置方式请参见[访问控制授权申请](../security/accesstoken-guidelines.md#配置文件权限声明)
Z
zengyawen 已提交
51 52 53 54 55

2. 申请数据同步权限,弹框示例代码。
   
   ```ts
   requestPermission() {   
zyjhandsome's avatar
zyjhandsome 已提交
56 57 58 59 60 61 62
       let context = this.context;
       let permissions: Array<string> = ['ohos.permission.DISTRIBUTED_DATASYNC'];
       context.requestPermissionsFromUser(permissions).then((data) => {
           console.info("Succeed to request permission from user with data: "+ JSON.stringify(data));
       }).catch((error) => {
           console.info("Failed to request permission from user with error: "+ JSON.stringify(error));
       })
Z
zengyawen 已提交
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131
   }
   ```

3. 获取目标设备的设备ID。
   
   ```ts
   import deviceManager from '@ohos.distributedHardware.deviceManager';
   
   let dmClass;
   function initDmClass() {
       // 其中createDeviceManager接口为系统API
       deviceManager.createDeviceManager('ohos.samples.demo', (err, dm) => {
           if (err) {
               // ...
               return
           }
           dmClass = dm
       })
   }
   function getRemoteDeviceId() {
       if (typeof dmClass === 'object' && dmClass !== null) {
           let list = dmClass.getTrustedDeviceListSync()
           if (typeof (list) === 'undefined' || typeof (list.length) === 'undefined') {
               console.info('EntryAbility onButtonClick getRemoteDeviceId err: list is null')
               return;
           }
           return list[0].deviceId
       } else {
           console.info('EntryAbility onButtonClick getRemoteDeviceId err: dmClass is null')
       }
   }
   ```

4. 设置目标组件参数,调用startAbility()接口,启动UIAbility或ServiceExtensionAbility。
   
   ```ts
   let want = {
       deviceId: getRemoteDeviceId(), 
       bundleName: 'com.example.myapplication',
       abilityName: 'FuncAbility',
       moduleName: 'module1', // moduleName非必选
   }
   // context为发起端UIAbility的AbilityContext
   this.context.startAbility(want).then(() => {
       // ...
   }).catch((err) => {
       // ...
   })
   ```


## 通过跨设备启动UIAbility组件实现多端协同(获取返回数据)

在设备A上通过应用提供的启动按钮,启动设备B上指定的UIAbility,当设备B上的UIAbility退出后,会将返回值发回设备A上的发起端应用。


### 接口说明

  **表2** 跨设备启动,返回结果数据API接口功能描述

| 接口名 | 描述 |
| -------- | -------- |
| startAbilityForResult(want:&nbsp;Want,&nbsp;callback:&nbsp;AsyncCallback&lt;AbilityResult&gt;):&nbsp;void; | 启动UIAbility并在该Ability退出的时候返回执行结果(callback形式)。 |
| terminateSelfWithResult(parameter:&nbsp;AbilityResult,&nbsp;callback:&nbsp;AsyncCallback&lt;void&gt;):&nbsp;void; | 停止UIAbility,配合startAbilityForResult使用,返回给接口调用方AbilityResult信息(callback形式)。 |
| terminateSelfWithResult(parameter:&nbsp;AbilityResult):&nbsp;Promise&lt;void&gt;; | 停止UIAbility,配合startAbilityForResult使用,返回给接口调用方AbilityResult信息(promise形式)。 |


### 开发步骤

132
1. 申请`ohos.permission.DISTRIBUTED_DATASYNC`权限,配置方式请参见[访问控制授权申请](../security/accesstoken-guidelines.md#配置文件权限声明)
Z
zengyawen 已提交
133 134 135 136 137

2. 申请数据同步权限,弹框示例代码。
   
   ```ts
   requestPermission() {   
zyjhandsome's avatar
zyjhandsome 已提交
138 139 140 141 142 143 144
       let context = this.context;
       let permissions: Array<string> = ['ohos.permission.DISTRIBUTED_DATASYNC'];
       context.requestPermissionsFromUser(permissions).then((data) => {
           console.info("Succeed to request permission from user with data: "+ JSON.stringify(data));
       }).catch((error) => {
           console.info("Failed to request permission from user with error: "+ JSON.stringify(error));
       })
Z
zengyawen 已提交
145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189
   }
   ```

3. 在发起端设置目标组件参数,调用startAbilityForResult()接口启动目标端UIAbility,异步回调中的data用于接收目标端UIAbility停止自身后返回给调用方UIAbility的信息。getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)
   
   ```ts
   let want = {
       deviceId: getRemoteDeviceId(), 
       bundleName: 'com.example.myapplication',
       abilityName: 'FuncAbility',
       moduleName: 'module1', // moduleName非必选
   }
   // context为发起端UIAbility的AbilityContext
   this.context.startAbilityForResult(want).then((data) => {
       // ...
   }).catch((err) => {
       // ...
   })
   ```

4. 在目标端UIAbility任务完成后,调用terminateSelfWithResult()方法,将数据返回给发起端的UIAbility。
   
   ```ts
   const RESULT_CODE: number = 1001;
   let abilityResult = {
       resultCode: RESULT_CODE,
       want: {
           bundleName: 'com.example.myapplication',
           abilityName: 'FuncAbility',
           moduleName: 'module1',
       },
   }
   // context为目标端UIAbility的AbilityContext
   this.context.terminateSelfWithResult(abilityResult, (err) => {
       // ...
   });
   ```

5. 发起端UIAbility接收到目标端UIAbility返回的信息,对其进行处理。
   
   ```ts
   const RESULT_CODE: number = 1001;
   
   // ...
   
190
   // context为调用方UIAbility的UIAbilityContext
Z
zengyawen 已提交
191 192 193 194 195 196 197 198 199 200 201 202 203 204
   this.context.startAbilityForResult(want).then((data) => {
       if (data?.resultCode === RESULT_CODE) {
           // 解析目标端UIAbility返回的信息
           let info = data.want?.parameters?.info
           // ...
       }
   }).catch((err) => {
       // ...
   })
   ```


## 通过跨设备连接ServiceExtensionAbility组件实现多端协同

Z
zhongjianfei 已提交
205
系统应用可以通过[connectServiceExtensionAbility()](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextconnectserviceextensionability)跨设备连接一个服务,实现跨设备远程调用。比如:分布式游戏场景,平板作为遥控器,智慧屏作为显示器。
Z
zengyawen 已提交
206 207 208 209 210 211 212 213 214 215 216 217 218 219 220


### 接口说明

  **表3** 跨设备连接API接口功能介绍

| 接口名 | 描述 |
| -------- | -------- |
| connectServiceExtensionAbility(want:&nbsp;Want,&nbsp;options:&nbsp;ConnectOptions):&nbsp;number; | 连接ServiceExtensionAbility。 |
| disconnectServiceExtensionAbility(connection:&nbsp;number,&nbsp;callback:AsyncCallback&lt;void&gt;):&nbsp;void; | 断开连接(callback形式)。 |
| disconnectServiceExtensionAbility(connection:&nbsp;number):&nbsp;Promise&lt;void&gt;; | 断开连接(promise形式)。 |


### 开发步骤

221
1. 申请`ohos.permission.DISTRIBUTED_DATASYNC`权限,配置方式请参见[访问控制授权申请](../security/accesstoken-guidelines.md#配置文件权限声明)
Z
zengyawen 已提交
222 223 224 225 226
   
2. 申请数据同步权限,弹框示例代码。
   
   ```ts
   requestPermission() {   
zyjhandsome's avatar
zyjhandsome 已提交
227 228 229 230 231 232 233
       let context = this.context;
       let permissions: Array<string> = ['ohos.permission.DISTRIBUTED_DATASYNC'];
       context.requestPermissionsFromUser(permissions).then((data) => {
           console.info("Succeed to request permission from user with data: "+ JSON.stringify(data));
       }).catch((error) => {
           console.info("Failed to request permission from user with error: "+ JSON.stringify(error));
       })
Z
zengyawen 已提交
234 235 236 237 238 239 240
   }
   ```

3. 如果已有后台服务,请直接进入下一步;如果没有,则[实现一个后台服务](serviceextensionability.md#实现一个后台服务仅对系统应用开放)

4. 连接一个后台服务。
   - 实现IAbilityConnection接口。IAbilityConnection提供了以下方法供开发者实现:onConnect()是用来处理连接Service成功的回调,onDisconnect()是用来处理Service异常终止的回调,onFailed()是用来处理连接Service失败的回调。
241
   - 设置目标组件参数,包括目标设备ID、Bundle名称、Ability名称。
Z
zengyawen 已提交
242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281
   - 调用connectServiceExtensionAbility发起连接。
   - 连接成功,收到目标设备返回的服务句柄。
   - 进行跨设备调用,获得目标端服务返回的结果。
     
      ```ts
      import rpc from '@ohos.rpc';
      
      const REQUEST_CODE = 99;
      let want = {
          "deviceId": getRemoteDeviceId(), 
          "bundleName": "com.example.myapplication",
          "abilityName": "ServiceExtAbility"
      };
      let options = {
          onConnect(elementName, remote) {
              console.info('onConnect callback');
              if (remote === null) {
                  console.info(`onConnect remote is null`);
                  return;
              }
              let option = new rpc.MessageOption();
              let data = new rpc.MessageParcel();
              let reply = new rpc.MessageParcel();
              data.writeInt(1);
              data.writeInt(99);  // 开发者可发送data到目标端应用进行相应操作
      
              // @param code 表示客户端发送的服务请求代码。
              // @param data 表示客户端发送的{@link MessageParcel}对象。
              // @param reply 表示远程服务发送的响应消息对象。
              // @param options 指示操作是同步的还是异步的。
              // 
              // @return 如果操作成功返回{@code true}; 否则返回 {@code false}。
              remote.sendRequest(REQUEST_CODE, data, reply, option).then((ret) => {
                  let msg = reply.readInt();   // 在成功连接的情况下,会收到来自目标端返回的信息(100)
                  console.info(`sendRequest ret:${ret} msg:${msg}`);
              }).catch((error) => {
                  console.info('sendRequest failed');
              });
          },
          onDisconnect(elementName) {
zyjhandsome's avatar
zyjhandsome 已提交
282
              console.info('onDisconnect callback');
Z
zengyawen 已提交
283 284
          },
          onFailed(code) {
zyjhandsome's avatar
zyjhandsome 已提交
285
              console.info('onFailed callback');
Z
zengyawen 已提交
286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329
          }
      }
      // 建立连接后返回的Id需要保存下来,在解绑服务时需要作为参数传入
      let connectionId = this.context.connectServiceExtensionAbility(want, options);
      ```

      getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)。

5. 断开连接。调用disconnectServiceExtensionAbility()断开与后台服务的连接。
   
   ```ts
   let connectionId = 1 // 在通过connectServiceExtensionAbility绑定服务时返回的Id
   this.context.disconnectServiceExtensionAbility(connectionId).then((data) => {
       console.info('disconnectServiceExtensionAbility success');
   }).catch((error) => {
       console.error('disconnectServiceExtensionAbility failed');
   })
   ```


## 通过跨设备Call调用实现多端协同

跨设备Call调用的基本原理与设备内Call调用相同,请参见[通过Call调用实现UIAbility交互(仅对系统应用开放)](uiability-intra-device-interaction.md#通过call调用实现uiability交互仅对系统应用开放)

下面介绍跨设备Call调用实现多端协同的方法。


### 接口说明

  **表4** Call API接口功能介绍

| 接口名 | 描述 |
| -------- | -------- |
| startAbilityByCall(want:&nbsp;Want):&nbsp;Promise&lt;Caller&gt;; | 启动指定UIAbility至前台或后台,同时获取其Caller通信接口,调用方可使用Caller与被启动的Ability进行通信。 |
| on(method:&nbsp;string,&nbsp;callback:&nbsp;CalleeCallBack):&nbsp;void | 通用组件Callee注册method对应的callback方法。 |
| off(method:&nbsp;string):&nbsp;void | 通用组件Callee解注册method的callback方法。 |
| call(method:&nbsp;string,&nbsp;data:&nbsp;rpc.Sequenceable):&nbsp;Promise&lt;void&gt; | 向通用组件Callee发送约定序列化数据。 |
| callWithResult(method:&nbsp;string,&nbsp;data:&nbsp;rpc.Sequenceable):&nbsp;Promise&lt;rpc.MessageParcel&gt; | 向通用组件Callee发送约定序列化数据,&nbsp;并将Callee返回的约定序列化数据带回。 |
| release():&nbsp;void | 释放通用组件的Caller通信接口。 |
| on(type:&nbsp;"release",&nbsp;callback:&nbsp;OnReleaseCallback):&nbsp;void | 注册通用组件通信断开监听通知。 |


### 开发步骤

330
1. 申请`ohos.permission.DISTRIBUTED_DATASYNC`权限,配置方式请参见[访问控制授权申请](../security/accesstoken-guidelines.md#配置文件权限声明)
Z
zengyawen 已提交
331 332 333 334 335
   
2. 申请数据同步权限,弹框示例代码。
   
   ```ts
   requestPermission() {   
zyjhandsome's avatar
zyjhandsome 已提交
336 337 338 339 340 341 342
       let context = this.context;
       let permissions: Array<string> = ['ohos.permission.DISTRIBUTED_DATASYNC'];
       context.requestPermissionsFromUser(permissions).then((data) => {
           console.info("Succeed to request permission from user with data: "+ JSON.stringify(data));
       }).catch((error) => {
           console.info("Failed to request permission from user with error: "+ JSON.stringify(error));
       })
Z
zengyawen 已提交
343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372
   }
   ```

3. 创建被调用端UIAbility。
   被调用端UIAbility需要实现指定方法的数据接收回调函数、数据的序列化及反序列化方法。在需要接收数据期间,通过on接口注册监听,无需接收数据时通过off接口解除监听。

   1. 配置UIAbility的启动模式。
       配置module.json5,将CalleeAbility配置为单实例"singleton"。

       | Json字段 | 字段说明 |
       | -------- | -------- |
       | “launchType” | Ability的启动模式,设置为"singleton"类型。 |

       UIAbility配置标签示例如下:

       
       ```json
       "abilities":[{
           "name": ".CalleeAbility",
           "srcEntrance": "./ets/CalleeAbility/CalleeAbility.ts",
           "launchType": "singleton",
           "description": "$string:CalleeAbility_desc",
           "icon": "$media:icon",
           "label": "$string:CalleeAbility_label",
           "visible": true
       }]
       ```
   2. 导入UIAbility模块。
      
       ```ts
zyjhandsome's avatar
zyjhandsome 已提交
373
       import Ability from '@ohos.app.ability.UIAbility';
Z
zengyawen 已提交
374 375 376 377 378 379 380
       ```
   3. 定义约定的序列化数据。
       调用端及被调用端发送接收的数据格式需协商一致,如下示例约定数据由number和string组成。

       
       ```ts
       export default class MySequenceable {
zyjhandsome's avatar
zyjhandsome 已提交
381 382
           num: number = 0;
           str: string = "";
Z
zengyawen 已提交
383 384
       
           constructor(num, string) {
zyjhandsome's avatar
zyjhandsome 已提交
385 386
               this.num = num;
               this.str = string;
Z
zengyawen 已提交
387 388 389
           }
       
           marshalling(messageParcel) {
zyjhandsome's avatar
zyjhandsome 已提交
390 391 392
               messageParcel.writeInt(this.num);
               messageParcel.writeString(this.str);
               return true;
Z
zengyawen 已提交
393 394 395
           }
       
           unmarshalling(messageParcel) {
zyjhandsome's avatar
zyjhandsome 已提交
396 397 398
               this.num = messageParcel.readInt();
               this.str = messageParcel.readString();
               return true;
Z
zengyawen 已提交
399 400 401 402 403 404 405
           }
       }
       ```
   4. 实现Callee.on监听及Callee.off解除监听。
         如下示例在Ability的onCreate注册MSG_SEND_METHOD监听,在onDestroy取消监听,收到序列化数据后作相应处理并返回。应用开发者根据实际业务需要做相应处理。
         
       ```ts
zyjhandsome's avatar
zyjhandsome 已提交
406 407
       const TAG: string = '[CalleeAbility]';
       const MSG_SEND_METHOD: string = 'CallSendMsg';
Z
zengyawen 已提交
408 409
       
       function sendMsgCallback(data) {
zyjhandsome's avatar
zyjhandsome 已提交
410
           console.info('CalleeSortFunc called');
Z
zengyawen 已提交
411 412
       
           // 获取Caller发送的序列化数据
zyjhandsome's avatar
zyjhandsome 已提交
413 414 415
           let receivedData = new MySequenceable(0, '');
           data.readSequenceable(receivedData);
           console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`);
Z
zengyawen 已提交
416 417 418
       
           // 作相应处理
           // 返回序列化数据result给Caller
zyjhandsome's avatar
zyjhandsome 已提交
419
           return new MySequenceable(receivedData.num + 1, `send ${receivedData.str} succeed`);
Z
zengyawen 已提交
420 421 422 423 424
       }
       
       export default class CalleeAbility extends Ability {
           onCreate(want, launchParam) {
               try {
zyjhandsome's avatar
zyjhandsome 已提交
425
                   this.callee.on(MSG_SEND_METHOD, sendMsgCallback);
Z
zengyawen 已提交
426
               } catch (error) {
zyjhandsome's avatar
zyjhandsome 已提交
427
                   console.info(`${MSG_SEND_METHOD} register failed with error ${JSON.stringify(error)}`);
Z
zengyawen 已提交
428 429 430 431 432
               }
           }
       
           onDestroy() {
               try {
zyjhandsome's avatar
zyjhandsome 已提交
433
                   this.callee.off(MSG_SEND_METHOD);
Z
zengyawen 已提交
434
               } catch (error) {
zyjhandsome's avatar
zyjhandsome 已提交
435
                   console.error(TAG, `${MSG_SEND_METHOD} unregister failed with error ${JSON.stringify(error)}`);
Z
zengyawen 已提交
436 437 438 439 440 441 442 443 444
               }
           }
       }
       ```

4. 获取Caller接口,访问被调用端UIAbility。
   1. 导入UIAbility模块。
      
       ```ts
zyjhandsome's avatar
zyjhandsome 已提交
445
       import Ability from '@ohos.app.ability.UIAbility';
Z
zengyawen 已提交
446 447 448 449 450 451 452
       ```
   2. 获取Caller通信接口。
       Ability的context属性实现了startAbilityByCall方法,用于获取指定通用组件的Caller通信接口。如下示例通过this.context获取Ability实例的context属性,使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口,注册Caller的onRelease监听。应用开发者根据实际业务需要做相应处理。

       
       ```ts
       async onButtonGetRemoteCaller() {
zyjhandsome's avatar
zyjhandsome 已提交
453 454
           var caller = undefined;
           var context = this.context;
Z
zengyawen 已提交
455 456 457 458 459 460 461
       
           context.startAbilityByCall({
               deviceId: getRemoteDeviceId(),
               bundleName: 'com.samples.CallApplication',
               abilityName: 'CalleeAbility'
           }).then((data) => {
               if (data != null) {
zyjhandsome's avatar
zyjhandsome 已提交
462 463
                   caller = data;
                   console.info('get remote caller success');
Z
zengyawen 已提交
464 465
                   // 注册caller的release监听
                   caller.onRelease((msg) => {
zyjhandsome's avatar
zyjhandsome 已提交
466
                       console.info(`remote caller onRelease is called ${msg}`);
Z
zengyawen 已提交
467
                   })
zyjhandsome's avatar
zyjhandsome 已提交
468
                   console.info('remote caller register OnRelease succeed');
Z
zengyawen 已提交
469 470
               }
           }).catch((error) => {
zyjhandsome's avatar
zyjhandsome 已提交
471
               console.error(`get remote caller failed with ${error}`);
Z
zengyawen 已提交
472 473 474 475 476 477 478 479 480 481
           })
       }
       ```

       getRemoteDeviceId方法参照[通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据](#通过跨设备启动uiability和serviceextensionability组件实现多端协同无返回数据)。

5. 向被调用端UIAbility发送约定序列化数据。
   1. 向被调用端发送Sequenceable数据有两种方式,一种是不带返回值,一种是获取被调用端返回的数据,method以及序列化数据需要与被调用端协商一致。如下示例调用Call接口,向Callee被调用端发送数据。
      
       ```ts
zyjhandsome's avatar
zyjhandsome 已提交
482
       const MSG_SEND_METHOD: string = 'CallSendMsg';
Z
zengyawen 已提交
483 484
       async onButtonCall() {
           try {
zyjhandsome's avatar
zyjhandsome 已提交
485 486
               let msg = new MySequenceable(1, 'origin_Msg');
               await this.caller.call(MSG_SEND_METHOD, msg);
Z
zengyawen 已提交
487
           } catch (error) {
zyjhandsome's avatar
zyjhandsome 已提交
488
               console.info(`caller call failed with ${error}`);
Z
zengyawen 已提交
489 490 491 492 493 494
           }
       }
       ```
   2. 如下示例调用CallWithResult接口,向Callee被调用端发送待处理的数据originMsg,并将’CallSendMsg’方法处理完毕的数据赋值给backMsg。
      
       ```ts
zyjhandsome's avatar
zyjhandsome 已提交
495 496 497
       const MSG_SEND_METHOD: string = 'CallSendMsg';
       originMsg: string = '';
       backMsg: string = '';
Z
zengyawen 已提交
498 499
       async onButtonCallWithResult(originMsg, backMsg) {
           try {
zyjhandsome's avatar
zyjhandsome 已提交
500 501 502
               let msg = new MySequenceable(1, originMsg);
               const data = await this.caller.callWithResult(MSG_SEND_METHOD, msg);
               console.info('caller callWithResult succeed');
Z
zengyawen 已提交
503
       
zyjhandsome's avatar
zyjhandsome 已提交
504 505 506 507
               let result = new MySequenceable(0, '');
               data.readSequenceable(result);
               backMsg(result.str);
               console.info(`caller result is [${result.num}, ${result.str}]`);
Z
zengyawen 已提交
508
           } catch (error) {
zyjhandsome's avatar
zyjhandsome 已提交
509
               console.info(`caller callWithResult failed with ${error}`);
Z
zengyawen 已提交
510 511 512 513 514 515 516 517 518 519
           }
       }
       ```

6. 释放Caller通信接口。
     Caller不再使用后,应用开发者可以通过release接口释放Caller。
     
   ```ts
   releaseCall() {
       try {
zyjhandsome's avatar
zyjhandsome 已提交
520
           this.caller.release();
Z
zengyawen 已提交
521
           this.caller = undefined
zyjhandsome's avatar
zyjhandsome 已提交
522
           console.info('caller release succeed');
Z
zengyawen 已提交
523
       } catch (error) {
zyjhandsome's avatar
zyjhandsome 已提交
524
           console.info(`caller release failed with ${error}`);
Z
zengyawen 已提交
525 526 527
       }
   }
   ```