1# UIAbility组件间交互（设备内） 2 3 4UIAbility是系统调度的最小单元。在设备内的功能模块之间跳转时，会涉及到启动特定的UIAbility，该UIAbility可以是应用内的其他UIAbility，也可以是其他应用的UIAbility（例如启动三方支付UIAbility）。 5 6 7本章节将从如下场景分别介绍设备内UIAbility间的交互方式。对于跨设备的应用组件交互，请参见[应用组件跨设备交互（流转）](inter-device-interaction-hop-overview.md)。 8 9 10- [启动应用内的UIAbility](#启动应用内的uiability) 11 12- [启动应用内的UIAbility并获取返回结果](#启动应用内的uiability并获取返回结果) 13 14- [启动其他应用的UIAbility](#启动其他应用的uiability) 15 16- [启动其他应用的UIAbility并获取返回结果](#启动其他应用的uiability并获取返回结果) 17 18- [启动UIAbility的指定页面](#启动uiability的指定页面) 19 20- [通过Call调用实现UIAbility交互（仅对系统应用开放）](#通过call调用实现uiability交互仅对系统应用开放) 21 22 23## 启动应用内的UIAbility 24 25当一个应用内包含多个UIAbility时，存在应用内启动UIAbility的场景。例如在支付应用中从入口UIAbility启动收付款UIAbility。 26 27假设应用中有两个UIAbility：EntryAbility和FuncAbility（可以在应用的一个Module中，也可以在的不同Module中），需要从EntryAbility的页面中启动FuncAbility。 28 291. 在EntryAbility中，通过调用startAbility()方法启动UIAbility，[want](../reference/apis/js-apis-app-ability-want.md)为UIAbility实例启动的入口参数，其中bundleName为待启动应用的Bundle名称，abilityName为待启动的UIAbility名称，moduleName在待启动的UIAbility属于不同的Module时添加，parameters为自定义信息参数。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 30 31 ```ts 32 let wantInfo = { 33 deviceId: '', // deviceId为空表示本设备 34 bundleName: 'com.example.myapplication', 35 abilityName: 'FuncAbility', 36 moduleName: 'module1', // moduleName非必选 37 parameters: { // 自定义信息 38 info: '来自EntryAbility Index页面', 39 }, 40 } 41 // context为调用方UIAbility的AbilityContext 42 this.context.startAbility(wantInfo).then(() => { 43 // ... 44 }).catch((err) => { 45 // ... 46 }) 47 ``` 48 492. 在FuncAbility的生命周期回调文件中接收EntryAbility传递过来的参数。 50 51 ```ts 52 import UIAbility from '@ohos.app.ability.UIAbility'; 53 import Window from '@ohos.window'; 54 55 export default class FuncAbility extends UIAbility { 56 onCreate(want, launchParam) { 57 // 接收调用方UIAbility传过来的参数 58 let funcAbilityWant = want; 59 let info = funcAbilityWant?.parameters?.info; 60 // ... 61 } 62 } 63 ``` 64 653. 在FuncAbility业务完成之后，如需要停止当前UIAbility实例，在FuncAbility中通过调用terminateSelf()方法实现。 66 67 ```ts 68 // context为需要停止的UIAbility实例的AbilityContext 69 this.context.terminateSelf((err) => { 70 // ... 71 }); 72 ``` 73 74 75## 启动应用内的UIAbility并获取返回结果 76 77在一个EntryAbility启动另外一个FuncAbility时，希望在被启动的FuncAbility完成相关业务后，能将结果返回给调用方。例如在应用中将入口功能和帐号登录功能分别设计为两个独立的UIAbility，在帐号登录UIAbility中完成登录操作后，需要将登录的结果返回给入口UIAbility。 78 791. 在EntryAbility中，调用startAbilityForResult()接口启动FuncAbility，异步回调中的data用于接收FuncAbility停止自身后返回给EntryAbility的信息。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 80 81 ```ts 82 let wantInfo = { 83 deviceId: '', // deviceId为空表示本设备 84 bundleName: 'com.example.myapplication', 85 abilityName: 'FuncAbility', 86 moduleName: 'module1', // moduleName非必选 87 parameters: { // 自定义信息 88 info: '来自EntryAbility Index页面', 89 }, 90 } 91 // context为调用方UIAbility的AbilityContext 92 this.context.startAbilityForResult(wantInfo).then((data) => { 93 // ... 94 }).catch((err) => { 95 // ... 96 }) 97 ``` 98 992. 在FuncAbility停止自身时，需要调用terminateSelfWithResult()方法，入参abilityResult为FuncAbility需要返回给EntryAbility的信息。 100 101 ```ts 102 const RESULT_CODE: number = 1001; 103 let abilityResult = { 104 resultCode: RESULT_CODE, 105 want: { 106 bundleName: 'com.example.myapplication', 107 abilityName: 'FuncAbility', 108 moduleName: 'module1', 109 parameters: { 110 info: '来自FuncAbility Index页面', 111 }, 112 }, 113 } 114 // context为被调用方UIAbility的AbilityContext 115 this.context.terminateSelfWithResult(abilityResult, (err) => { 116 // ... 117 }); 118 ``` 119 1203. FuncAbility停止自身后，EntryAbility通过startAbilityForResult()方法回调接收被FuncAbility返回的信息，RESULT_CODE需要与前面的数值保持一致。 121 122 ```ts 123 const RESULT_CODE: number = 1001; 124 125 // ... 126 127 // context为调用方UIAbility的AbilityContext 128 this.context.startAbilityForResult(want).then((data) => { 129 if (data?.resultCode === RESULT_CODE) { 130 // 解析被调用方UIAbility返回的信息 131 let info = data.want?.parameters?.info; 132 // ... 133 } 134 }).catch((err) => { 135 // ... 136 }) 137 ``` 138 139 140## 启动其他应用的UIAbility 141 142启动其他应用的UIAbility，通常用户只需要完成一个通用的操作（例如需要选择一个文档应用来查看某个文档的内容信息），推荐使用[隐式Want启动](want-overview.md#want的类型)。系统会根据调用方的want参数来识别和启动匹配到的应用UIAbility。 143 144启动UIAbility有[显式Want启动和隐式Want启动](want-overview.md)两种方式。 145 146- 显式Want启动：启动一个确定应用的UIAbility，在want参数中需要设置该应用bundleName和abilityName，当需要拉起某个明确的UIAbility时，通常使用显式Want启动方式。 147 148- 隐式Want启动：根据匹配条件由用户选择启动哪一个UIAbility，即不明确指出要启动哪一个UIAbility（abilityName参数未设置），在调用startAbility()方法时，其入参want中指定了一系列的[entities](../reference/apis/js-apis-ability-wantConstant.md#wantconstantentity)字段（表示目标UIAbility额外的类别信息，如浏览器、视频播放器）和[actions](../reference/apis/js-apis-ability-wantConstant.md#wantconstantaction)字段（表示要执行的通用操作，如查看、分享、应用详情等）等参数信息，然后由系统去分析want，并帮助找到合适的UIAbility来启动。当需要拉起其他应用的UIAbility时，开发者通常不知道用户设备中应用的安装情况，也无法确定目标应用的bundleName和abilityName，通常使用隐式Want启动方式。 149 150本章节主要讲解如何通过隐式Want启动其他应用的UIAbility。 151 1521. 将多个待匹配的文档应用安装到设备，在其对应UIAbility的module.json5配置文件中，配置skills的[entities](../reference/apis/js-apis-ability-wantConstant.md#wantconstantentity)字段和[actions](../reference/apis/js-apis-ability-wantConstant.md#wantconstantaction)字段。 153 154 ```json 155 { 156 "module": { 157 "abilities": [ 158 { 159 // ... 160 "skills": [ 161 { 162 "entities": [ 163 // ... 164 "entity.system.default" 165 ], 166 "actions": [ 167 // ... 168 "ohos.want.action.viewData" 169 ] 170 } 171 ] 172 } 173 ] 174 } 175 } 176 ``` 177 1782. 在调用方want参数中的entities和action需要被包含在待匹配UIAbility的skills配置的entities和actions中。系统匹配到符合entities和actions参数条件的UIAbility后，会弹出选择框展示匹配到的UIAbility实例列表供用户选择使用。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 179 180 ```ts 181 let wantInfo = { 182 deviceId: '', // deviceId为空表示本设备 183 // uncomment line below if wish to implicitly query only in the specific bundle. 184 // bundleName: 'com.example.myapplication', 185 action: 'ohos.want.action.viewData', 186 // entities can be omitted. 187 entities: ['entity.system.default'], 188 } 189 190 // context为调用方UIAbility的AbilityContext 191 this.context.startAbility(wantInfo).then(() => { 192 // ... 193 }).catch((err) => { 194 // ... 195 }) 196 ``` 197 198 效果示意如下图所示，点击“打开PDF文档”时，会弹出选择框供用户选择。 199 200  201 2023. 在文档应用使用完成之后，如需要停止当前UIAbility实例，通过调用terminateSelf()方法实现。 203 204 ```ts 205 // context为需要停止的UIAbility实例的AbilityContext 206 this.context.terminateSelf((err) => { 207 // ... 208 }); 209 ``` 210 211 212## 启动其他应用的UIAbility并获取返回结果 213 214当使用隐式Want启动其他应用的UIAbility并希望获取返回结果时，调用方需要使用startAbilityForResult()方法启动目标UIAbility。例如主应用中需要启动三方支付并获取支付结果。 215 2161. 在支付应用对应UIAbility的module.json5配置文件中，配置skills的[entities](../reference/apis/js-apis-ability-wantConstant.md#wantconstantentity)字段和[actions](../reference/apis/js-apis-ability-wantConstant.md#wantconstantaction)字段。 217 218 ```json 219 { 220 "module": { 221 "abilities": [ 222 { 223 // ... 224 "skills": [ 225 { 226 "entities": [ 227 // ... 228 "entity.system.default" 229 ], 230 "actions": [ 231 // ... 232 "ohos.want.action.editData" 233 ] 234 } 235 ] 236 } 237 ] 238 } 239 } 240 ``` 241 2422. 调用方使用startAbilityForResult()方法启动支付应用的UIAbility，在调用方want参数中的entities和action需要被包含在待匹配UIAbility的skills配置的entities和actions中。异步回调中的data用于后续接收支付UIAbility停止自身后返回给调用方的信息。系统匹配到符合entities和actions参数条件的UIAbility后，会弹出选择框展示匹配到的UIAbility实例列表供用户选择使用。 243 244 ```ts 245 let wantInfo = { 246 deviceId: '', // deviceId为空表示本设备 247 // uncomment line below if wish to implicitly query only in the specific bundle. 248 // bundleName: 'com.example.myapplication', 249 action: 'ohos.want.action.editData', 250 // entities can be omitted. 251 entities: ['entity.system.default'], 252 } 253 254 // context为调用方UIAbility的AbilityContext 255 this.context.startAbilityForResult(wantInfo).then((data) => { 256 // ... 257 }).catch((err) => { 258 // ... 259 }) 260 ``` 261 2623. 在支付UIAbility完成支付之后，需要调用terminateSelfWithResult()方法实现停止自身，并将abilityResult参数信息返回给调用方。 263 264 ```ts 265 const RESULT_CODE: number = 1001; 266 let abilityResult = { 267 resultCode: RESULT_CODE, 268 want: { 269 bundleName: 'com.example.myapplication', 270 abilityName: 'EntryAbility', 271 moduleName: 'entry', 272 parameters: { 273 payResult: 'OKay', 274 }, 275 }, 276 } 277 // context为被调用方UIAbility的AbilityContext 278 this.context.terminateSelfWithResult(abilityResult, (err) => { 279 // ... 280 }); 281 ``` 282 2834. 在调用方startAbilityForResult()方法回调中接收支付应用返回的信息，RESULT_CODE需要与前面terminateSelfWithResult()返回的数值保持一致。 284 285 ```ts 286 const RESULT_CODE: number = 1001; 287 288 let want = { 289 // Want参数信息 290 }; 291 292 // context为调用方UIAbility的AbilityContext 293 this.context.startAbilityForResult(want).then((data) => { 294 if (data?.resultCode === RESULT_CODE) { 295 // 解析被调用方UIAbility返回的信息 296 let payResult = data.want?.parameters?.payResult; 297 // ... 298 } 299 }).catch((err) => { 300 // ... 301 }) 302 ``` 303 304 305## 启动UIAbility的指定页面 306 307一个UIAbility可以对应多个页面，在不同的场景下启动该UIAbility时需要展示不同的页面，例如从一个UIAbility的页面中跳转到另外一个UIAbility时，希望启动目标UIAbility的指定页面。本文主要讲解目标UIAbility首次启动和目标UIAbility非首次启动两种启动指定页面的场景，以及在讲解启动指定页面之前会讲解到在调用方如何指定启动页面。 308 309 310### 调用方UIAbility指定启动页面 311 312调用方UIAbility启动另外一个UIAbility时，通常需要跳转到指定的页面。例如FuncAbility包含两个页面（Index对应首页，Second对应功能A页面），此时需要在传入的want参数中配置指定的页面路径信息，可以通过want中的parameters参数增加一个自定义参数传递页面跳转信息。示例中的context的获取方式参见[获取UIAbility的Context属性](uiability-usage.md#获取uiability的上下文信息)。 313 314 315```ts 316let wantInfo = { 317 deviceId: '', // deviceId为空表示本设备 318 bundleName: 'com.example.myapplication', 319 abilityName: 'FuncAbility', 320 moduleName: 'module1', // moduleName非必选 321 parameters: { // 自定义参数传递页面信息 322 router: 'funcA', 323 }, 324} 325// context为调用方UIAbility的AbilityContext 326this.context.startAbility(wantInfo).then(() => { 327 // ... 328}).catch((err) => { 329 // ... 330}) 331``` 332 333 334### 目标UIAbility首次启动 335 336目标UIAbility首次启动时，在目标UIAbility的onWindowStageCreate()生命周期回调中，解析EntryAbility传递过来的want参数，获取到需要加载的页面信息url，传入windowStage.loadContent()方法。 337 338 339```ts 340import UIAbility from '@ohos.app.ability.UIAbility' 341import Window from '@ohos.window' 342 343export default class FuncAbility extends UIAbility { 344 funcAbilityWant; 345 346 onCreate(want, launchParam) { 347 // 接收调用方UIAbility传过来的参数 348 this.funcAbilityWant = want; 349 } 350 351 onWindowStageCreate(windowStage: Window.WindowStage) { 352 // Main window is created, set main page for this ability 353 let url = 'pages/Index'; 354 if (this.funcAbilityWant?.parameters?.router) { 355 if (this.funcAbilityWant.parameters.router === 'funA') { 356 url = 'pages/Second'; 357 } 358 } 359 windowStage.loadContent(url, (err, data) => { 360 // ... 361 }); 362 } 363} 364``` 365 366 367### 目标UIAbility非首次启动 368 369经常还会遇到一类场景，当应用A已经启动且处于主页面时，回到桌面，打开应用B，并从应用B再次启动应用A，且需要跳转到应用A的指定页面。例如联系人应用和短信应用配合使用的场景。打开短信应用主页，回到桌面，此时短信应用处于已打开状态且当前处于短信应用的主页。再打开联系人应用主页，进入联系人用户A查看详情，点击短信图标，准备给用户A发送短信，此时会再次拉起短信应用且当前处于短信应用的发送页面。 370 371 372 373针对以上场景，即当应用A的UIAbility实例已创建，并且处于该UIAbility实例对应的主页面中，此时，从应用B中需要再次启动应用A的该UIAbility，并且需要跳转到不同的页面，这种情况下要如何实现呢？ 374 3751. 在目标UIAbility中，默认加载的是Index页面。由于当前UIAbility实例之前已经创建完成，此时会进入UIAbility的onNewWant()回调中且不会进入onCreate()和onWindowStageCreate()生命周期回调，在onNewWant()回调中解析调用方传递过来的want参数，并挂在到全局变量globalThis中，以便于后续在页面中获取。 376 377 ```ts 378 import UIAbility from '@ohos.app.ability.UIAbility' 379 380 export default class FuncAbility extends UIAbility { 381 onNewWant(want, launchParam) { 382 // 接收调用方UIAbility传过来的参数 383 globalThis.funcAbilityWant = want; 384 // ... 385 } 386 } 387 ``` 388 3892. 在FuncAbility中，此时需要在Index页面中通过页面路由Router模块实现指定页面的跳转，由于此时FuncAbility对应的Index页面是处于激活状态，不会重新变量声明以及进入aboutToAppear()生命周期回调中。因此可以在Index页面的onPageShow()生命周期回调中实现页面路由跳转的功能。 390 391 ```ts 392 import router from '@ohos.router'; 393 394 @Entry 395 @Component 396 struct Index { 397 onPageShow() { 398 let funcAbilityWant = globalThis.funcAbilityWant; 399 let url2 = funcAbilityWant?.parameters?.router; 400 if (url2 && url2 === 'funcA') { 401 router.replaceUrl({ 402 url: 'pages/Second', 403 }) 404 } 405 } 406 407 // 页面展示 408 build() { 409 // ... 410 } 411 } 412 ``` 413 414>  **说明：** 415> 当被调用方[Ability的启动模式](uiability-launch-type.md)设置为standard启动模式时，每次启动都会创建一个新的实例，那么[onNewWant()](../reference/apis/js-apis-app-ability-uiAbility.md#abilityonnewwant)回调就不会被用到。 416 417 418## 通过Call调用实现UIAbility交互（仅对系统应用开放） 419 420Call调用是UIAbility能力的扩展，它为UIAbility提供一种能够被外部调用并与外部进行通信的能力。Call调用支持前台与后台两种启动方式，使UIAbility既能被拉起到前台展示UI，也可以在后台被创建并运行。Call调用在调用方与被调用方间建立了IPC通信，因此应用开发者可通过Call调用实现不同Ability之间的数据共享。 421 422Call调用的核心接口是startAbilityByCall方法，与startAbility接口的不同之处在于： 423 424- startAbilityByCall支持前台与后台两种启动方式，而startAbility仅支持前台启动。 425 426- 调用方可使用startAbilityByCall所返回的Caller对象与被调用方进行通信，而startAbilty不具备通信能力。 427 428Call调用的使用场景主要包括： 429 430- 需要与被启动的UIAbility进行通信。 431 432- 希望被启动的UIAbility在后台运行。 433 434 **表1** Call调用相关名词解释 435 436| 名词 | 描述 | 437| -------- | -------- | 438| CallerAbility | 进行Call调用的UIAbility（调用方）。 | 439| CalleeAbility | 被Call调用的UIAbility（被调用方）。 | 440| Caller | 实际对象，由startAbilityByCall接口返回，CallerAbility可使用Caller与CalleeAbility进行通信。 | 441| Callee | 实际对象，被CalleeAbility持有，可与Caller进行通信。 | 442 443Call调用示意图如下所示。 444 445 **图1** Call调用示意图 446 447  448 449- CallerAbility调用startAbilityByCall接口获取Caller，并使用Caller对象的call方法向CalleeAbility发送数据。 450 451- CalleeAbility持有一个Callee对象，通过Callee的on方法注册回调函数，当接收到Caller发送的数据时将会调用对应的回调函数。 452 453>  **说明：** 454> 1. 当前仅支持系统应用使用Call调用。 455> 456> 2. CalleeAbility的启动模式需要为单实例。 457> 458> 3. Call调用既支持本地（设备内）Call调用，也支持跨设备Call调用，下面介绍设备内Call调用方法。跨设备Call调用方法请参见[跨设备Call调用](hop-multi-device-collaboration.md#通过跨设备call调用实现多端协同)。 459 460 461### 接口说明 462 463Call功能主要接口如下表所示。具体的API详见[接口文档](../reference/apis/js-apis-app-ability-uiAbility.md#caller)。 464 465 **表2** Call功能主要接口 466 467| 接口名 | 描述 | 468| -------- | -------- | 469| startAbilityByCall(want: Want): Promise<Caller> | 启动指定UIAbility并获取其Caller通信接口，默认为后台启动，通过配置want可实现前台启动，详见[接口文档](../reference/apis/js-apis-inner-application-uiAbilityContext.md#abilitycontextstartabilitybycall)。AbilityContext与ServiceExtensionContext均支持该接口。 | 470| on(method: string, callback: CalleeCallBack): void | 通用组件Callee注册method对应的callback方法。 | 471| off(method: string): void | 通用组件Callee解注册method的callback方法。 | 472| call(method: string, data: rpc.Parcelable): Promise<void> | 向通用组件Callee发送约定序列化数据。 | 473| callWithResult(method: string, data: rpc.Parcelable): Promise<rpc.MessageSequence> | 向通用组件Callee发送约定序列化数据, 并将Callee返回的约定序列化数据带回。 | 474| release(): void | 释放通用组件的Caller通信接口。 | 475| on(type: "release", callback: OnReleaseCallback): void | 注册通用组件通信断开监听通知。 | 476 477设备内通过Call调用实现UIAbility交互，涉及如下两部分开发： 478 479- [创建Callee被调用端](#开发步骤创建callee被调用端) 480 481- [访问Callee被调用端](#开发步骤访问callee被调用端) 482 483 484### 开发步骤（创建Callee被调用端） 485 486在Callee被调用端，需要实现指定方法的数据接收回调函数、数据的序列化及反序列化方法。在需要接收数据期间，通过on接口注册监听，无需接收数据时通过off接口解除监听。 487 4881. 配置Ability的启动模式。 489 配置module.json5，将CalleeAbility配置为单实例"singleton"。 490 491 | Json字段 | 字段说明 | 492 | -------- | -------- | 493 | "launchType" | Ability的启动模式，设置为"singleton"类型。 | 494 495 Ability配置标签示例如下： 496 497 498 ```json 499 "abilities":[{ 500 "name": ".CalleeAbility", 501 "srcEntrance": "./ets/CalleeAbility/CalleeAbility.ts", 502 "launchType": "singleton", 503 "description": "$string:CalleeAbility_desc", 504 "icon": "$media:icon", 505 "label": "$string:CalleeAbility_label", 506 "visible": true 507 }] 508 ``` 509 5102. 导入UIAbility模块。 511 512 ```ts 513 import Ability from '@ohos.app.ability.UIAbility'; 514 ``` 515 5163. 定义约定的序列化数据。 517 调用端及被调用端发送接收的数据格式需协商一致，如下示例约定数据由number和string组成。 518 519 520 ```ts 521 export default class MyParcelable { 522 num: number = 0 523 str: string = "" 524 525 constructor(num, string) { 526 this.num = num 527 this.str = string 528 } 529 530 marshalling(messageSequence) { 531 messageSequence.writeInt(this.num) 532 messageSequence.writeString(this.str) 533 return true 534 } 535 536 unmarshalling(messageSequence) { 537 this.num = messageSequence.readInt() 538 this.str = messageSequence.readString() 539 return true 540 } 541 } 542 ``` 543 5444. 实现Callee.on监听及Callee.off解除监听。 545 被调用端Callee的监听函数注册时机，取决于应用开发者。注册监听之前的数据不会被处理，取消监听之后的数据不会被处理。如下示例在Ability的onCreate注册'MSG_SEND_METHOD'监听，在onDestroy取消监听，收到序列化数据后作相应处理并返回，应用开发者根据实际需要做相应处理。具体示例代码如下： 546 547 548 ```ts 549 const TAG: string = '[CalleeAbility]'; 550 const MSG_SEND_METHOD: string = 'CallSendMsg'; 551 552 function sendMsgCallback(data) { 553 console.info('CalleeSortFunc called'); 554 555 // 获取Caller发送的序列化数据 556 let receivedData = new MyParcelable(0, ''); 557 data.readParcelable(receivedData); 558 console.info(`receiveData[${receivedData.num}, ${receivedData.str}]`); 559 560 // 作相应处理 561 // 返回序列化数据result给Caller 562 return new MyParcelable(receivedData.num + 1, `send ${receivedData.str} succeed`); 563 } 564 565 export default class CalleeAbility extends Ability { 566 onCreate(want, launchParam) { 567 try { 568 this.callee.on(MSG_SEND_METHOD, sendMsgCallback); 569 } catch (error) { 570 console.info(`${MSG_SEND_METHOD} register failed with error ${JSON.stringify(error)}`); 571 } 572 } 573 574 onDestroy() { 575 try { 576 this.callee.off(MSG_SEND_METHOD); 577 } catch (error) { 578 console.error(TAG, `${MSG_SEND_METHOD} unregister failed with error ${JSON.stringify(error)}`); 579 } 580 } 581 } 582 ``` 583 584 585### 开发步骤（访问Callee被调用端） 586 5871. 导入UIAbility模块。 588 589 ```ts 590 import Ability from '@ohos.app.ability.UIAbility'; 591 ``` 592 5932. 获取Caller通信接口。 594 Ability的context属性实现了startAbilityByCall方法，用于获取指定通用组件的Caller通信接口。如下示例通过this.context获取Ability实例的context属性，使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口，注册Caller的onRelease监听。应用开发者根据实际需要做相应处理。 595 596 597 ```ts 598 // 注册caller的release监听 599 private regOnRelease(caller) { 600 try { 601 caller.on("release", (msg) => { 602 console.info(`caller onRelease is called ${msg}`); 603 }) 604 console.info('caller register OnRelease succeed'); 605 } catch (error) { 606 console.info(`caller register OnRelease failed with ${error}`); 607 } 608 } 609 610 async onButtonGetCaller() { 611 try { 612 this.caller = await context.startAbilityByCall({ 613 bundleName: 'com.samples.CallApplication', 614 abilityName: 'CalleeAbility' 615 }) 616 if (this.caller === undefined) { 617 console.info('get caller failed') 618 return 619 } 620 console.info('get caller success') 621 this.regOnRelease(this.caller) 622 } catch (error) { 623 console.info(`get caller failed with ${error}`) 624 } 625 } 626 ``` 627
