【HarmonyOS NEXT】鸿蒙系统文件选择器（FilePicker）选择用户文件

最新推荐文章于 2025-05-14 16:10:43 发布

ConneyWu

最新推荐文章于 2025-05-14 16:10:43 发布

阅读量2.8k

点赞数 28

分类专栏： harmony 文章标签： harmonyos 华为鸿蒙系统鸿蒙

本文链接：https://blog.csdn.net/wu1004019946/article/details/139681705

版权

用户有时需要分享或保存图片、视频等用户文件，开发者可以通过系统预置的文件选择器（FilePicker），实现该能力。通过Picker访问相关文件，将拉起对应的应用，引导用户完成界面操作，接口本身无需申请权限。

根据用户文件的常见类型，选择器（FilePicker）分别提供以下接口：

PhotoViewPicker：适用于图片或视频类型文件的选择与保存。优选使用PhotoAccessHelper的PhotoViewPicker来选择文件。当前PhotoViewPicker对接的选择资源来自于图库，保存位置为系统文件管理器的特定目录，因此使用save接口保存的图片或视频无法在图库中展示。如需在图库中展示，请使用安全控件创建媒体资源。
DocumentViewPicker：适用于文件类型文件的选择与保存。DocumentViewPicker对接的选择资源来自于FilePicker, 负责文件类型的资源管理，文件类型不区分后缀，比如浏览器下载的图片、文档等，都属于文件类型。
AudioViewPicker：适用于音频类型文件的选择与保存。AudioViewPicker目前对接的选择资源来自于FilePicker。

导入选择器模块和文件管理模块。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';

创建图片-视频类型文件选择选项实例。

import picker from '@ohos.file.picker';

const photoSelectOptions = new pi