HarmonyOS Next开发学习手册——通过startAbility拉起文件处理类应用

使用场景

开发者可以通过调用startAbility接口，由系统从已安装的应用中寻找符合要求的应用来实现打开特定文件的意图，例如：浏览器下应用下载PDF文件，可以调用此接口选择文件处理应用打开此PDF文件。开发者需要在请求中设置待打开文件的URI路径（uri）、文件格式（type）等字段，以便系统能够识别，直接拉起文件打开应用或弹出一个选择框，让用户选择合适的应用来打开文件，效果示意如下图所示。

图1 效果示意图

接口关键参数说明

开发者通过调用 startAbility 接口即可实现由已安装的垂域应用来打开文件。

表1 startAbility请求中want相关参数说明

参数名称	类型	是否必填	说明
uri	string	是	表示待打开文件的URI路径，一般配合type使用。 uri格式为：file://bundleName/path * file：文件URI的标志。 * bundleName：该文件资源的属主。* path：文件资源在应用沙箱中的路径。
type	string	否	表示MIME type类型描述，打开文件的类型。比如：‘text/xml’ 、 'image/*'等，MIME定义请参见https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。
parameters	Record<string, Object>	否	表示由系统定义，由开发者按需赋值的自定义参数，文件打开场景请参考表2。
flags	number	否	表示处理方式，文件打开场景请参考表3。

表2 parameters 相关参数说明

参数名称	类型	说明
ability.params.stream	string<