c396bc89创建于 2025年9月25日历史提交

@ohos.app.ability.insightIntent (意图框架基础定义)

本模块提供意图框架基础定义。

说明：

本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

导入模块

import { insightIntent } from '@kit.AbilityKit';

意图执行模式。表示系统入口触发意图执行时传递的执行模式，每个意图支持的执行模式在意图开发时定义。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称	值	说明
UI_ABILITY_FOREGROUND	0	将UIAbility在前台显示。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
UI_ABILITY_BACKGROUND	1	将UIAbility在后台拉起。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
UI_EXTENSION_ABILITY	2	拉起UIExtensionAbility。

意图执行的返回结果。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

名称	类型	只读	可选	说明
code	number	否	否	意图执行返回的错误码，由开发者定义。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
result	Record<string, Object>	否	是	意图执行返回的结果，通常会包含需要返回给系统入口的数据。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
uris¹⁸⁺	Array<string>	否	是	意图执行返回的URI列表。该字段需要与flags字段配合使用，根据URI列表将flags字段的相应权限授权给系统入口。原子化服务API：从API version 18开始，该接口支持在原子化服务中使用。
flags¹⁸⁺	number	否	是	意图执行返回给系统入口的URI列表的授权权限。原子化服务API：从API version 18开始，该接口支持在原子化服务中使用。说明：该参数仅支持FLAG_AUTH_READ_URI_PERMISSION、FLAG_AUTH_WRITE_URI_PERMISSION、FLAG_AUTH_READ_URI_PERMISSION\|FLAG_AUTH_WRITE_URI_PERMISSION。权限介绍见Flags。