• 启动应用内的UIAbility
  
• 启动应用内的UIAbility并获取返回结果
  
• 启动其他应用的UIAbility
  
• 启动其他应用的UIAbility并获取返回结果
  
• 启动UIAbility指定窗口模式（仅对系统应用开放）
  
• 启动UIAbility的指定页面
  
• 通过Call调用实现UIAbility交互（仅对系统应用开放）
  
  

• 在EntryAbility中，通过调用startAbility()方法启动UIAbility，want为UIAbility实例启动的入口参数，其中bundleName为待启动应用的Bundle名称，abilityName为待启动的Ability名称，moduleName在待启动的UIAbility属于不同的Module时添加，parameters为自定义信息参数。示例中的context的获取方式请参见获取UIAbility的上下文信息。
  import common from '@ohos.app.ability.common';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';import hilog from '@ohos.hilog';const TAG: string = '[Page_UIAbilityComponentsInteractive]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  private context = getContext(this) as common.UIAbilityContext;  build() {    ...    Button()      .onClick(() => {    // context为Ability对象的成员，在非Ability对象内部调用需要        // 将Context对象传递过去        let wantInfo: Want = {          deviceId: '', // deviceId为空表示本设备          bundleName: 'com.samples.myapplication',          moduleName: 'entry', // moduleName非必选          abilityName: 'FuncAbilityA',          parameters: { // 自定义信息            info: '来自EntryAbility Page_UIAbilityComponentsInteractive页面'          },        }        // context为调用方UIAbility的UIAbilityContext        this.context.startAbility(wantInfo).then(() => {          hilog.info(DOMAIN_NUMBER, TAG, 'startAbility success.');        }).catch((error: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, 'startAbility failed.');        });      })  }}
  
• 在FuncAbility的onCreate()或者onNewWant()生命周期回调文件中接收EntryAbility传递过来的参数。
  import UIAbility from '@ohos.app.ability.UIAbility';import AbilityConstant from '@ohos.app.ability.AbilityConstant';import Want from '@ohos.app.ability.Want';export default class FuncAbility extends UIAbility {  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    // 接收调用方UIAbility传过来的参数    let funcAbilityWant = want;    let info = funcAbilityWant?.parameters?.info;    // ...  }}

  说明：
  在被拉起的FuncAbility中，可以通过获取传递过来的want参数的parameters来获取拉起方UIAbility的PID、Bundle Name等信息。
  

  
  
• 在FuncAbility业务完成之后，如需要停止当前UIAbility实例，在FuncAbility中通过调用terminateSelf()方法实现。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';const TAG: string = '[Page_UIAbilityComponentsInteractive]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    ...    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        // context为需要停止的UIAbility实例的AbilityContext        context.terminateSelf((err) => {          if (err.code) {            hilog.error(DOMAIN_NUMBER, TAG, `Failed to terminate Self. Code is ${err.code}, message is ${err.message}`);            return;          }        });      })  }}

  说明：
  调用terminateSelf()方法停止当前UIAbility实例时，默认会保留该实例的快照（Snapshot），即在最近任务列表中仍然能查看到该实例对应的任务。如不需要保留该实例的快照，可以在其对应UIAbility的module.json5配置文件中，将abilities标签的removeMissionAfterTerminate字段配置为true。
  

  
  
• 如需要关闭应用所有的UIAbility实例，可以调用ApplicationContext的killAllProcesses()方法实现关闭应用所有的进程。
  
  

• 在EntryAbility中，调用startAbilityForResult()接口启动FuncAbility，异步回调中的data用于接收FuncAbility停止自身后返回给EntryAbility的信息。示例中的context的获取方式请参见获取UIAbility的上下文信息。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';const TAG: string = '[Page_UIAbilityComponentsInteractive]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        let want: Want = {          deviceId: '', // deviceId为空表示本设备          bundleName: 'com.samples.stagemodelabilitydevelop',          moduleName: 'entry', // moduleName非必选          abilityName: 'FuncAbilityA',          parameters: { // 自定义信息            info: '来自EntryAbility UIAbilityComponentsInteractive页面'          }        };        context.startAbilityForResult(want).then((data) => {          // ...        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability for result. Code is ${err.code}, message is ${err.message}`);        });      })  }}
  
• 在FuncAbility停止自身时，需要调用terminateSelfWithResult()方法，入参abilityResult为FuncAbility需要返回给EntryAbility的信息。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';const TAG: string = '[Page_FuncAbilityA]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_FuncAbilityA {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        const RESULT_CODE: number = 1001;        let abilityResult: common.AbilityResult = {          resultCode: RESULT_CODE,          want: {            bundleName: 'com.samples.stagemodelabilitydevelop',            moduleName: 'entry', // moduleName非必选            abilityName: 'FuncAbilityB',            parameters: {              info: '来自FuncAbility Index页面'            },          },        };        context.terminateSelfWithResult(abilityResult, (err) => {          if (err.code) {            hilog.error(DOMAIN_NUMBER, TAG, `Failed to terminate self with result. Code is ${err.code}, message is ${err.message}`);            return;          }        });      })  }}
  
• FuncAbility停止自身后，EntryAbility通过startAbilityForResult()方法回调接收被FuncAbility返回的信息，RESULT_CODE需要与前面的数值保持一致。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';import promptAction from '@ohos.promptAction';const TAG: string = '[EntryAbility]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        const RESULT_CODE: number = 1001;        let want: Want = {          deviceId: '', // deviceId为空表示本设备          bundleName: 'com.samples.stagemodelabilitydevelop',          moduleName: 'entry', // moduleName非必选          abilityName: 'FuncAbilityA',          parameters: { // 自定义信息            info: '来自EntryAbility UIAbilityComponentsInteractive页面'          }        };        context.startAbilityForResult(want).then((data) => {          if (data?.resultCode === RESULT_CODE) {            // 解析被调用方UIAbility返回的信息            let info = data.want?.parameters?.info;            hilog.info(DOMAIN_NUMBER, TAG, JSON.stringify(info) ?? '');            if (info !== null) {              promptAction.showToast({                message: JSON.stringify(info)              });            }          }          hilog.info(DOMAIN_NUMBER, TAG, JSON.stringify(data.resultCode) ?? '');        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability for result. Code is ${err.code}, message is ${err.message}`);        });      })  }}
  
  

• 显式Want启动：启动一个确定应用的UIAbility，在want参数中需要设置该应用bundleName和abilityName，当需要拉起某个明确的UIAbility时，通常使用显式Want启动方式。
  
• 隐式Want启动：根据匹配条件由用户选择启动哪一个UIAbility，即不明确指出要启动哪一个UIAbility（abilityName参数未设置），在调用startAbility()方法时，其入参want中指定了一系列的entities字段（表示目标UIAbility额外的类别信息，如浏览器、视频播放器）和actions字段（表示要执行的通用操作，如查看、分享、应用详情等）等参数信息，然后由系统去分析want，并帮助找到合适的UIAbility来启动。当需要拉起其他应用的UIAbility时，开发者通常不知道用户设备中应用的安装情况，也无法确定目标应用的bundleName和abilityName，通常使用隐式Want启动方式。
  
  

• 将多个待匹配的文档应用安装到设备，在其对应UIAbility的module.json5配置文件中，配置skills标签的entities字段和actions字段。
  
  

• 在调用方want参数中的entities和action需要被包含在待匹配UIAbility的skills配置的entities和actions中。系统匹配到符合entities和actions参数条件的UIAbility后，会弹出选择框展示匹配到的UIAbility实例列表供用户选择使用。示例中的context的获取方式请参见获取UIAbility的上下文信息。
  import common from '@ohos.app.ability.common';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';import hilog from '@ohos.hilog';const TAG: string = '[Page_UIAbilityComponentsInteractive]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        let want: Want = {          deviceId: '', // deviceId为空表示本设备          // uncomment line below if wish to implicitly query only in the specific bundle.          // bundleName: 'com.samples.stagemodelabilityinteraction',          action: 'ohos.want.action.viewData',          // entities can be omitted.          entities: ['entity.system.default']        };        // context为调用方UIAbility的UIAbilityContext        context.startAbility(want).then(() => {          hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in starting FuncAbility.');        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start FuncAbility. Code is ${err.code}, message is ${err.message}`);        });      })  }}效果示意如下图所示，点击“打开PDF文档”时，会弹出选择框供用户选择。
  
• 在文档应用使用完成之后，如需要停止当前UIAbility实例，通过调用terminateSelf()方法实现。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';const TAG: string = '[Page_FromStageModel]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_FromStageModel {  @State message: string = 'Hello World'  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        // context为需要停止的UIAbility实例的AbilityContext        context.terminateSelf((err) => {          if (err.code) {            hilog.error(DOMAIN_NUMBER, TAG, `Failed to terminate self. Code is ${err.code}, message is ${err.message}`);            return;          }        });      })  }}
  
  

• 在支付应用对应UIAbility的module.json5配置文件中，配置skills的entities字段和actions字段。
  {  "module": {    "abilities": [      {        ...        "skills": [          {            "entities": [              ...              "entity.system.default"            ],            "actions": [              ...              "ohos.want.action.editData"            ]          }        ]      }    ]  }}
  
• 调用方使用startAbilityForResult()方法启动支付应用的UIAbility，在调用方want参数中的entities和action需要被包含在待匹配UIAbility的skills标签配置的entities和actions中。异步回调中的data用于后续接收支付UIAbility停止自身后返回给调用方的信息。系统匹配到符合entities和actions参数条件的UIAbility后，会弹出选择框展示匹配到的UIAbility实例列表供用户选择使用。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';const TAG: string = '[Page_UIAbilityComponentsInteractive]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        let want: Want = {          deviceId: '', // deviceId为空表示本设备          bundleName: 'com.samples.stagemodelabilitydevelop',          moduleName: 'entry', // moduleName非必选          abilityName: 'FuncAbilityA',          parameters: { // 自定义信息            info: '来自EntryAbility UIAbilityComponentsInteractive页面'          }        };        context.startAbilityForResult(want).then((data) => {          // ...        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability for result. Code is ${err.code}, message is ${err.message}`);        });      })  }}
  
• 在支付UIAbility完成支付之后，需要调用terminateSelfWithResult()方法实现停止自身，并将abilityResult参数信息返回给调用方。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';const TAG: string = '[Page_FuncAbilityA]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_FuncAbilityA {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        const RESULT_CODE: number = 1001;        let abilityResult: common.AbilityResult = {          resultCode: RESULT_CODE,          want: {            bundleName: 'com.samples.stagemodelabilitydevelop',            moduleName: 'entry', // moduleName非必选            abilityName: 'FuncAbilityB',            parameters: {              info: '来自FuncAbility Index页面'            },          },        };        context.terminateSelfWithResult(abilityResult, (err) => {          if (err.code) {            hilog.error(DOMAIN_NUMBER, TAG, `Failed to terminate self with result. Code is ${err.code}, message is ${err.message}`);            return;          }        });      })  }}
  
• 在调用方startAbilityForResult()方法回调中接收支付应用返回的信息，RESULT_CODE需要与前面terminateSelfWithResult()返回的数值保持一致。
  import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';import promptAction from '@ohos.promptAction';const TAG: string = '[EntryAbility]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        const RESULT_CODE: number = 1001;        let want: Want = {          deviceId: '', // deviceId为空表示本设备          bundleName: 'com.samples.stagemodelabilitydevelop',          moduleName: 'entry', // moduleName非必选          abilityName: 'FuncAbilityA',          parameters: { // 自定义信息            info: '来自EntryAbility UIAbilityComponentsInteractive页面'          }        };        context.startAbilityForResult(want).then((data) => {          if (data?.resultCode === RESULT_CODE) {            // 解析被调用方UIAbility返回的信息            let info = data.want?.parameters?.info;            hilog.info(DOMAIN_NUMBER, TAG, JSON.stringify(info) ?? '');            if (info !== null) {              promptAction.showToast({                message: JSON.stringify(info)              });            }          }          hilog.info(DOMAIN_NUMBER, TAG, JSON.stringify(data.resultCode) ?? '');        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability for result. Code is ${err.code}, message is ${err.message}`);        });      })  }}
  
  

说明：

• 如果在使用startAbility()方法启动UIAbility时，入参中未指定StartOptions参数的windowMode属性，那么UIAbility将以系统默认的窗口展示形态启动。
  
• 为了确保启动的UIAbility展示形态能够被支持，需要在该UIAbility对应的module.json5配置文件中abilities标签的supportWindowMode字段确认启动的展示形态被支持。
  
  

• 在调用startAbility()方法时，增加StartOptions参数。
  
• 在StartOptions参数中设置windowMode字段为WINDOW_MODE_FLOATING，表示启动的UIAbility将以悬浮窗的形式展示。
  
• windowMode属性仅适用于系统应用，三方应用可以使用displayId属性。
  
  

示例中的context的获取方式请参见获取UIAbility的上下文信息。
import AbilityConstant from '@ohos.app.ability.AbilityConstant';import common from '@ohos.app.ability.common';import hilog from '@ohos.hilog';import StartOptions from '@ohos.app.ability.StartOptions';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';const TAG: string = '[Page_UIAbilityComponentsInteractive]';const DOMAIN_NUMBER: number = 0xFF00;@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        let want: Want = {          deviceId: '', // deviceId为空表示本设备          bundleName: 'com.samples.stagemodelabilitydevelop',          moduleName: 'entry', // moduleName非必选          abilityName: 'FuncAbilityB',          parameters: { // 自定义信息            info: '来自EntryAbility Index页面'          }        };        let options: StartOptions = {          windowMode: AbilityConstant.WindowMode.WINDOW_MODE_FLOATING        };        // context为调用方UIAbility的UIAbilityContext        context.startAbility(want, options).then(() => {          hilog.info(DOMAIN_NUMBER, TAG, 'Succeeded in starting ability.');        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability. Code is ${err.code}, message is ${err.message}`);        });      })  }}效果示意如下图所示。
启动UIAbility的指定页面

概述

一个UIAbility可以对应多个页面，在不同的场景下启动该UIAbility时需要展示不同的页面，例如从一个UIAbility的页面中跳转到另外一个UIAbility时，希望启动目标UIAbility的指定页面。
UIAbility的启动分为两种情况：UIAbility冷启动和UIAbility热启动。

• UIAbility冷启动：指的是UIAbility实例处于完全关闭状态下被启动，这需要完整地加载和初始化UIAbility实例的代码、资源等。
  
• UIAbility热启动：指的是UIAbility实例已经启动并在前台运行过，由于某些原因切换到后台，再次启动该UIAbility实例，这种情况下可以快速恢复UIAbility实例的状态。
  
  

• 用户先打开短信应用，短信应用的UIAbility实例启动，显示短信应用的主页。
  
• 用户将设备回到桌面界面，短信应用进入后台运行状态。
  
• 用户打开联系人应用，找到联系人张三。
  
• 用户点击联系人张三的短信按钮，会重新启动短信应用的UIAbility实例。
  
• 由于短信应用的UIAbility实例已经启动过了，此时会触发该UIAbility的onNewWant()回调，而不会再走onCreate()和onWindowStageCreate()等初始化逻辑。
  
  

图1 目标UIAbility热启动

开发步骤如下所示。

• 冷启动短信应用的UIAbility实例时，在onWindowStageCreate()生命周期回调中，通过调用getUIContext()接口获取UI上下文实例UIContext对象。
  import hilog from '@ohos.hilog';import UIAbility from '@ohos.app.ability.UIAbility';import Want from '@ohos.app.ability.Want';import window from '@ohos.window';import { UIContext } from '@ohos.arkui.UIContext';const DOMAIN_NUMBER: number = 0xFF00;const TAG: string = '[EntryAbility]';export default class EntryAbility extends UIAbility {  funcAbilityWant: Want | undefined = undefined;  uiContext: UIContext | undefined = undefined;  // ...  onWindowStageCreate(windowStage: window.WindowStage): void {    // Main window is created, set main page for this ability    let url = 'pages/Index';    if (this.funcAbilityWant?.parameters?.router && this.funcAbilityWant.parameters.router === 'funcA') {      url = 'pages/Page_ColdStartUp';    }    windowStage.loadContent(url, (err, data) => {      if (err.code) {        return;      }      let windowClass: window.Window;      windowStage.getMainWindow((err, data) => {        if (err.code) {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to obtain the main window. Code is ${err.code}, message is ${err.message}`);          return;        }        windowClass = data;        this.uiContext = windowClass.getUIContext();      })    });  }}
  
• 在短信应用UIAbility的onNewWant()回调中解析调用方传递过来的want参数，通过调用UIContext中的getRouter()方法获取Router对象，并进行指定页面的跳转。此时再次启动该短信应用的UIAbility实例时，即可跳转到该短信应用的UIAbility实例的指定页面。
  import AbilityConstant from '@ohos.app.ability.AbilityConstant';import hilog from '@ohos.hilog';import UIAbility from '@ohos.app.ability.UIAbility';import Want from '@ohos.app.ability.Want';import { BusinessError } from '@ohos.base';import { Router, UIContext } from '@ohos.arkui.UIContext';const DOMAIN_NUMBER: number = 0xFF00;const TAG: string = '[EntryAbility]';export default class EntryAbility extends UIAbility {  funcAbilityWant: Want | undefined = undefined;  uiContext: UIContext | undefined = undefined;  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {    if (want?.parameters?.router && want.parameters.router === 'funcB') {      let funcAUrl = 'pages/Page_HotStartUp';      if (this.uiContext) {        let router: Router = this.uiContext.getRouter();        router.pushUrl({          url: funcAUrl        }).catch((err: BusinessError) => {       hilog.error(DOMAIN_NUMBER, TAG, `Failed to push url. Code is ${err.code}, message is ${err.message}`);        });      }    }  }  // ...}
  
  

说明：
当被调用方UIAbility组件启动模式设置为multiton启动模式时，每次启动都会创建一个新的实例，那么onNewWant()回调就不会被用到。

• startAbilityByCall支持前台与后台两种启动方式，而startAbility()仅支持前台启动。
  
• 调用方可使用startAbilityByCall()所返回的Caller对象与被调用方进行通信，而startAbility()不具备通信能力。
  
  

• 需要与被启动的UIAbility进行通信。
  
• 希望被启动的UIAbility在后台运行。
  
  

Call调用示意图如下所示。
图1 Call调用示意图

• CallerAbility调用startAbilityByCall接口获取Caller，并使用Caller对象的call方法向CalleeAbility发送数据。
  
• CalleeAbility持有一个Callee对象，通过Callee的on方法注册回调函数，当接收到Caller发送的数据时将会调用对应的回调函数。
  
  

说明：

• 当前仅支持系统应用使用Call调用。
  
• CalleeAbility的启动模式需要为单实例。
  
• Call调用既支持本地（设备内）Call调用，也支持跨设备Call调用，下面介绍设备内Call调用方法。跨设备Call调用方法请参见跨设备Call调用。
  
  

• 创建Callee被调用端
  
• 访问Callee被调用端
  
  

• 配置UIAbility的启动模式。
  例如将CalleeAbility配置为单实例模式singleton，配置方式请参见UIAbility组件启动模式。
  
• 导入UIAbility模块。
  import UIAbility from '@ohos.app.ability.UIAbility';
  
• 定义约定的序列化数据。调用端及被调用端发送接收的数据格式需协商一致，如下示例约定数据由number和string组成。
  import type rpc from '@ohos.rpc';class MyParcelable {  num: number = 0;  str: string = '';  constructor(num: number, string: string) {    this.num = num;    this.str = string;  };  mySequenceable(num, string): void {    this.num = num;    this.str = string;  };  marshalling(messageSequence: rpc.MessageSequence): boolean {    messageSequence.writeInt(this.num);    messageSequence.writeString(this.str);    return true;  };  unmarshalling(messageSequence: rpc.MessageSequence): boolean {    this.num = messageSequence.readInt();    this.str = messageSequence.readString();    return true;  };};
  
• 实现Callee.on监听及Callee.off解除监听。
  被调用端Callee的监听函数注册时机，取决于应用开发者。注册监听之前的数据不会被处理，取消监听之后的数据不会被处理。如下示例在UIAbility的onCreate注册’MSG_SEND_METHOD’监听，在onDestroy取消监听，收到序列化数据后作相应处理并返回，应用开发者根据实际需要做相应处理。具体示例代码如下：
  import type AbilityConstant from '@ohos.app.ability.AbilityConstant';import UIAbility from '@ohos.app.ability.UIAbility';import type Want from '@ohos.app.ability.Want';import hilog from '@ohos.hilog';import Logger from '../utils/Logger';import type rpc from '@ohos.rpc';import type { Caller } from '@ohos.app.ability.UIAbility';const MSG_SEND_METHOD: string = 'CallSendMsg';const DOMAIN_NUMBER: number = 0xFF00;const TAG: string = '[CalleeAbility]';class MyParcelable {  num: number = 0;  str: string = '';  constructor(num: number, string: string) {    this.num = num;    this.str = string;  }  mySequenceable(num, string): void {    this.num = num;    this.str = string;  }  marshalling(messageSequence: rpc.MessageSequence): boolean {    messageSequence.writeInt(this.num);    messageSequence.writeString(this.str);    return true;  };  unmarshalling(messageSequence: rpc.MessageSequence): boolean {    this.num = messageSequence.readInt();    this.str = messageSequence.readString();    return true;  };};function sendMsgCallback(data: rpc.MessageSequence): rpc.Parcelable {  hilog.info(DOMAIN_NUMBER, TAG, '%{public}s', 'CalleeSortFunc called');  // 获取Caller发送的序列化数据  let receivedData: MyParcelable = new MyParcelable(0, '');  data.readParcelable(receivedData);  hilog.info(DOMAIN_NUMBER, TAG, '%{public}s', `receiveData[${receivedData.num}, ${receivedData.str}]`);  let num: number = receivedData.num;  // 作相应处理  // 返回序列化数据result给Caller  return new MyParcelable(num + 1, `send ${receivedData.str} succeed`) as rpc.Parcelable;}export default class CalleeAbility extends UIAbility {  caller: Caller | undefined;  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    try {      this.callee.on(MSG_SEND_METHOD, sendMsgCallback);    } catch (error) {      hilog.error(DOMAIN_NUMBER, TAG, '%{public}s', `Failed to register. Error is ${error}`);    };  }  releaseCall(): void {    try {      if (this.caller) {        this.caller.release();        this.caller = undefined;      }      Logger.info('caller release succeed');    } catch (error) {      Logger.info(`caller release failed with ${error}`);    };  }  onDestroy(): void {    try {      this.callee.off(MSG_SEND_METHOD);      hilog.info(DOMAIN_NUMBER, TAG, '%{public}s', 'Callee OnDestroy');      this.releaseCall();    } catch (error) {      hilog.error(DOMAIN_NUMBER, TAG, '%{public}s', `Failed to register. Error is ${error}`);    };  }}
  
  

• 导入UIAbility模块。
  import UIAbility from '@ohos.app.ability.UIAbility';
  
• 获取Caller通信接口。UIAbilityContext属性实现了startAbilityByCall方法，用于获取指定通用组件的Caller通信接口。如下示例通过this.context获取UIAbility实例的context属性，使用startAbilityByCall拉起Callee被调用端并获取Caller通信接口，注册Caller的onRelease监听。应用开发者根据实际需要做相应处理。
  import { Caller } from '@ohos.app.ability.UIAbility';import { BusinessError } from '@ohos.base';import common from '@ohos.app.ability.common';import promptAction from '@ohos.promptAction';import hilog from '@ohos.hilog';import Want from '@ohos.app.ability.Want';const DOMAIN_NUMBER: number = 0xFF00;const TAG: string = '[Page_UIAbilityComponentsInteractive]';@Entry@Componentstruct Page_UIAbilityComponentsInteractive {  caller: Caller | undefined = undefined;  // 注册caller的release监听  private regOnRelease(caller: Caller): void {    hilog.info(DOMAIN_NUMBER, TAG, `caller is ${caller}`);    try {      caller.on('release', (msg: string) => {        hilog.info(DOMAIN_NUMBER, TAG, `caller onRelease is called ${msg}`);      })      hilog.info(DOMAIN_NUMBER, TAG, 'succeeded in registering on release.');    } catch (err) {      let code = (err as BusinessError).code;      let message = (err as BusinessError).message;      hilog.error(DOMAIN_NUMBER, TAG, `Failed to caller register on release. Code is ${code}, message is ${message}`);    }    ;  }  build() {    Button()      .onClick(() => {        let context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // UIAbilityContext        let want: Want = {          bundleName: 'com.samples.stagemodelabilityinteraction',          abilityName: 'CalleeAbility',          parameters: { // 自定义信息            info: 'CallSendMsg'          }        };        context.startAbilityByCall(want).then((caller: Caller) => {          hilog.info(DOMAIN_NUMBER, TAG, `Succeeded in starting ability.Code is ${caller}`);          if (caller === undefined) {            hilog.info(DOMAIN_NUMBER, TAG, 'get caller failed');            return;          }          else {            hilog.info(DOMAIN_NUMBER, TAG, 'get caller success');            this.regOnRelease(caller);            promptAction.showToast({              message: $r('app.string.CallerSuccess')            });          }        }).catch((err: BusinessError) => {          hilog.error(DOMAIN_NUMBER, TAG, `Failed to start ability. Code is ${err.code}, message is ${err.message}`);        });      })  }}
  
  

• UIAbility内和UIAbility间页面的跳转（ArkTS）（API9）
  
• UIAbility内页面间的跳转（ArkTS）（API9）