harmony-utils 之 PickerUtil，拍照、文件选择和保存, 工具类

2025-06-26
安徽
本文字数：2613 字
阅读完需：约 9 分钟

harmony-utils 之 PickerUtil，拍照、文件选择和保存,工具类

harmony-utils 简介与说明

harmony-utils 一款功能丰富且极易上手的 HarmonyOS 工具库，借助众多实用工具类，致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了 APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志，异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON 等一系列的功能和操作，能够满足各种不同的开发需求。

picker_utils 是 harmony-utils 拆分出来的一个子库，包含 PickerUtil、PhotoHelper、ScanUtil。

下载安装

ohpm i @pura/harmony-utils

ohpm i @pura/picker_utils

  //全局初始化方法，在UIAbility的onCreate方法中初始化 AppUtil.init()  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    AppUtil.init(this.context);  }

复制代码

API 方法与使用

camera 调用系统相机，拍照、录视频

PickerUtil.cameraEasy().then((uri) => {  let uriStr = `调用相机，返回uri：\n${uri}`;}).catch((err: BusinessError) => {  let str = `调用相机，异常：\n${JSON.stringify(err)}`;});

复制代码

cameraEasy 调用系统相机，拍照、录视频

let options: CameraOptions = {  mediaTypes: [cameraPicker.PickerMediaType.PHOTO],  cameraPosition: camera.CameraPosition.CAMERA_POSITION_BACK}PickerUtil.camera(options).then((result) => {  let uriStr = `调用相机，返回uri：\n${result.resultUri}`;}).catch((err: BusinessError) => {  let str = `调用相机，异常：\n${JSON.stringify(err)}`;});

复制代码

selectPhoto 通过选择模式拉起 photoPicker 界面，用户可以选择一个或多个图片/视频

PickerUtil.selectPhoto().then((uris) => {  let uriStr = `调用相册，返回uris：\n${uris.join('\n')}`;}).catch((err: BusinessError) => {  let str = `调用相册，异常：\n${JSON.stringify(err)}`;});

复制代码

savePhoto 通过保存模式拉起 photoPicker 进行保存图片或视频资源的文件名，若无参数，则默认需要用户自行输入

let imgName = `大漂亮_${DateUtil.getTodayTime()}.png`;let imgName1 = `小漂亮_${DateUtil.getTodayTime()}.png`;PickerUtil.savePhoto([imgName, imgName1]).then(async (uris) => {  let uri = uris[0];  let uriStr = `调用保存图片，返回uris：\n${uri}`;  let file = FileUtil.openSync(uri);  FileUtil.copyFile(this.filePath, file.fd).then(() => {    let uriStr = `保存图片，返回uris：\n${uri}`;    ToastUtil.showToast("图片1保存成功");  });
  let file1 = FileUtil.openSync(uris[1]);  let pixelMap1 = await ImageUtil.getPixelMapFromMedia($r("app.media.test_as3"));  let packOpts: image.PackingOption = { format: 'image/png', quality: 100 };  ImageUtil.packToFileFromPixelMap(pixelMap1, file1.fd, packOpts).then(() => {    let uriStr = `保存图片，返回uris：\n${uris[1]}`;    ToastUtil.showToast("图片2保存成功");  });}).catch((err: BusinessError) => {  let uriStr = `调用保存图片，异常：\n${JSON.stringify(err)}`;})

复制代码

selectDocument 通过选择模式拉起 documentPicker 界面，用户可以选择一个或多个文件

let options: picker.DocumentSelectOptions = {  maxSelectNumber: 9, //选择媒体文件数量的最大值,默认9。  selectMode: picker.DocumentSelectMode.FILE, //支持选择的资源类型,默认文件  // fileSuffixFilters: ['图片(.png, .jpg)|.png,.jpg', '文档|.txt', '视频|.mp4', '.pdf'], //选择文件的后缀类型['后缀类型描述|后缀类型']（可选） 若选择项存在多个后缀名，则每一个后缀名之间用英文逗号进行分隔（可选），后缀类型名不能超过100,选择所有文件：'所有文件(*.*)|.*';  // defaultFilePathUri: "file://docs/storage/Users/currentUser/Download/com.harmony.utils", //指定选择的文件或者目录路径（可选）  // authMode: true //选择是否对指定文件或目录授权，true为授权，当为true时，defaultFilePathUri为必选参数。}PickerUtil.selectDocument(options).then((uris) => {  let uriStr = `调用文件管理，返回uris：\n${uris.join('\n')}`}).catch((err: BusinessError) => {  let uriStr = `调用文件管理，异常：\n${JSON.stringify(err)}`});

复制代码

saveDocument 通过保存模式拉起 documentPicker 界面，用户可以保存一个或多个文件

let fileName = `test_easy_${DateUtil.getTodayTime()}.txt`;PickerUtil.saveDocumentEasy([fileName]).then((paths) => {  let path = paths[0];  this.cacheUri = FileUtil.getUriFromPath(path);  PreferencesUtil.put("picker_cache_uri", this.cacheUri);  let txtStr = `“harmony-utils 一款高效的OpenHarmony/HarmonyOS工具包，封装了常用工具类，提供一系列简单易用的方法。帮助开发者快速构建鸿蒙应用。\n\n`;  FileUtil.writeEasy(path, txtStr).then(() => {    let uriStr = `文件保存成功，返回uris：\n${path}`;    ToastUtil.showToast("文件保存成功！");  }).catch((err: BusinessError) => {    let uriStr = `文件保存，异常：\n${JSON.stringify(err)}`;  })}).catch((err: BusinessError) => {  let uriStr = `调用保存文件，异常：\n${JSON.stringify(err)}`;})

复制代码

selectAudio 通过选择模式拉起 audioPicker 界面，用户可以选择一个或多个音频文件

PickerUtil.selectAudio().then((uris) => {  let uriStr = `调用文件管理，返回uris：\n${uris.join('\n')}`;}).catch((err: BusinessError) => {  let uriStr = `调用文件管理，异常：\n${JSON.stringify(err)}`;});

复制代码

saveAudio 通过保存模式拉起 audioPicker 界面，用户可以保存一个或多个音频文件

let fileName = `AudioViewPicker001.mp3`;PickerUtil.saveAudio([fileName]).then((uris) => {  let uri = uris[0];  let uriStr = `音频文件，返回uris：\n${uri}`;}).catch((err: BusinessError) => {  let uriStr = `调用保存文件，异常：\n${JSON.stringify(err)}`;})

复制代码