@ohos.app.ability.wantConstant (wantConstant)
wantConstant模块提供want中操作want常数和解释Flags说明的能力。
说明：
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
导入模块
import { wantConstant } from '@kit.AbilityKit';
Params
want的Params操作的常量。
系统能力：SystemCapability.Ability.AbilityBase
| 名称 | 值 | 说明 |
|---|---|---|
| ABILITY_BACK_TO_OTHER_MISSION_STACK | ability.params.backToOtherMissionStack | 表示是否支持跨任务链返回。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| ABILITY_RECOVERY_RESTART10+ | ohos.ability.params.abilityRecoveryRestart | 指示当前Ability是否发生了故障恢复重启。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| CONTENT_TITLE_KEY10+ | ohos.extra.param.key.contentTitle | 指示原子化服务支持分享标题的参数的操作。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| SHARE_ABSTRACT_KEY10+ | ohos.extra.param.key.shareAbstract | 指示原子化服务支持分享内容的参数的操作。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| SHARE_URL_KEY10+ | ohos.extra.param.key.shareUrl | 指示原子化服务支持分享链接的参数的操作。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| SUPPORT_CONTINUE_PAGE_STACK_KEY10+ | ohos.extra.param.key.supportContinuePageStack | 指示在跨端迁移过程中是否迁移页面栈信息，默认值为true，自动迁移页面栈信息。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| SUPPORT_CONTINUE_SOURCE_EXIT_KEY10+ | ohos.extra.param.key.supportContinueSourceExit | 指示跨端迁移源端应用是否退出，默认值为true，源端应用自动退出。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| SHOW_MODE_KEY12+ | ohos.extra.param.key.showMode | 指示展示模式，值为枚举类型wantConstant.ShowMode 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| PARAMS_STREAM12+ | ability.params.stream | 指示携带的文件URI要授权给目标方。对应的value必须是string类型的文件URI数组。文件URI的获取参考fileUri 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| APP_CLONE_INDEX_KEY12+ | ohos.extra.param.key.appCloneIndex | 指示分身应用索引。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| CALLER_REQUEST_CODE12+ | ohos.extra.param.key.callerRequestCode | 当调用startAbilityForResult或openLink拉起目标方Ability时, 需要目标方返回结果。为了确保目标方能够将结果准确返回到调用方，系统会自动生成唯一的requestCode，以标识本次调用。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| PAGE_PATH12+ | ohos.param.atomicservice.pagePath | 指示页面参数路径。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| ROUTER_NAME12+ | ohos.param.atomicservice.routerName | 指示页面路由名称。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| PAGE_SOURCE_FILE12+ | ohos.param.atomicservice.pageSourceFile | 指示页面源文件。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| BUILD_FUNCTION12+ | ohos.param.atomicservice.buildFunction | 指示生成函数的参数。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| SUB_PACKAGE_NAME12+ | ohos.param.atomicservice.subpackageName | 指示子包名。 原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。 |
| APP_INSTANCE_KEY14+ | ohos.extra.param.key.appInstance | 指示具体的应用实例。 |
| CREATE_APP_INSTANCE_KEY14+ | ohos.extra.param.key.createAppInstance | 指示创建新应用实例。 |
| CALLER_APP_CLONE_INDEX14+ | ohos.param.callerAppCloneIndex | 指示拉起方应用的分身索引。 |
| LAUNCH_REASON_MESSAGE18+ | ohos.params.launchReasonMessage | 调用方拉起目标方Ability时，可通过该字段设置拉起原因。调用方必须为系统应用，且需要申请ohos.permission.SET_LAUNCH_REASON_MESSAGE权限。当前取值仅支持"ReasonMessage_SystemShare"。 原子化服务API：从API version 18开始，该接口支持在原子化服务中使用。 |
Flags
Flags说明。用于表示处理Want的方式。
系统能力：SystemCapability.Ability.AbilityBase
| 名称 | 值 | 说明 |
|---|---|---|
| FLAG_AUTH_READ_URI_PERMISSION | 0x00000001 | 指示对URI执行读取操作的授权。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| FLAG_AUTH_WRITE_URI_PERMISSION | 0x00000002 | 指示对URI执行写入操作的授权。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| FLAG_AUTH_PERSISTABLE_URI_PERMISSION12+ | 0x00000040 | 指示该URI可被接收方持久化。该字段仅在2in1和tablet设备上生效。 |
| FLAG_INSTALL_ON_DEMAND | 0x00000800 | 如果未安装指定的功能，请安装该功能。 原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。 |
| FLAG_START_WITHOUT_TIPS11+ | 0x40000000 | 如果隐式启动能力不能匹配任何应用程序，则不会弹出提示对话框。 |
| FLAG_ABILITY_ON_COLLABORATE18+ | 0x00002000 | 在多设备协同场景下，调用方应用通过DMS系统发起请求并且通过Flags字段携带此标志，协同方应用才会触发生命周期回调方法onCollaborate(wantParam)。 |
ShowMode12+
ShowMode说明。用于表示拉起原子化服务的展示模式。
原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
系统能力：SystemCapability.Ability.AbilityBase
| 名称 | 值 | 说明 |
|---|---|---|
| WINDOW | 0 | 指示独立窗口拉起模式。 |
| EMBEDDED_FULL | 1 | 指示嵌入式全屏拉起模式。 |