更新记录

1.0.2（2026-03-04）

拓展

1.0.1（2026-03-02）

优化

1.0.0（2026-03-02）

初始版本

平台兼容性

uni-app(4.62)

uni-app x(4.62)

umini-saveMedia

鸿蒙平台媒体文件保存插件，支持将图片和视频保存到系统相册。

特性：支持批量保存多张图片/视频，用户只需确认一次即可完成全部保存。

平台支持

• HarmonyOS (鸿蒙)

安装

将 umini-saveMedia 目录放入项目的 uni_modules 目录下。

uniapp和低版本uniappx需要使用源码版才能编译运行

权限配置

如果需要使用权限模式（usePermission: true），需要在项目中配置 ohos.permission.WRITE_IMAGEVIDEO 权限。

推荐使用 harmony-permissions 插件来简化权限配置。

API

saveImageToPhotosAlbum(saveOption)

保存图片到相册。

保存模式说明

• 默认模式（不设置 usePermission 或设置为 false）：会弹出系统确认对话框，用户确认后将图片保存到相册
• 权限模式（设置 usePermission 为 true）：会申请 ohos.permission.WRITE_IMAGEVIDEO 权限，成功后直接写入相册，不弹出确认对话框

参数说明

文件路径说明

• 支持临时文件路径
• 支持永久文件路径
• 不支持网络路径

示例

import { saveImageToPhotosAlbum } from '@/uni_modules/umini-saveMedia'

// 保存单张图片（默认模式，弹出确认对话框）
uni.downloadFile({
  url: 'https://example.com/image.png',
  success: (res) => {
    if (res.statusCode === 200) {
      saveImageToPhotosAlbum({
        filePaths: [res.tempFilePath],
        callback: (success) => {
          console.log(success ? '保存成功' : '保存失败')
        }
      })
    }
  }
})

// 批量保存多张图片（默认模式，弹出确认对话框）
saveImageToPhotosAlbum({
  filePaths: [
    '/path/to/image1.png',
    '/path/to/image2.jpg',
    '/path/to/image3.jpg'
  ],
  callback: (success) => {
    console.log(success ? '保存成功' : '保存失败')
  }
})

// 使用权限模式保存图片（不弹出确认对话框，直接写入）
saveImageToPhotosAlbum({
  filePaths: ['/path/to/image.jpg'],
  usePermission: true,
  callback: (success) => {
    console.log(success ? '保存成功' : '保存失败')
  }
})

saveVideoToPhotosAlbum(saveOption)

保存视频到相册。

保存模式说明

• 默认模式（不设置 usePermission 或设置为 false）：会弹出系统确认对话框，用户确认后将视频保存到相册
• 权限模式（设置 usePermission 为 true）：会申请 ohos.permission.WRITE_IMAGEVIDEO 权限，成功后直接写入相册，不弹出确认对话框

参数说明

文件路径说明

• 支持临时文件路径
• 支持永久文件路径
• 不支持网络路径

示例

import { saveVideoToPhotosAlbum } from '@/uni_modules/umini-saveMedia'

// 保存下载的视频（默认模式，弹出确认对话框）
uni.downloadFile({
  url: 'https://example.com/video.mp4',
  success: (res) => {
    if (res.statusCode === 200) {
      saveVideoToPhotosAlbum({
        filePaths: [res.tempFilePath],
        callback: (success) => {
          console.log(success ? '保存成功' : '保存失败')
        }
      })
    }
  }
})

// 使用权限模式保存视频（不弹出确认对话框，直接写入）
saveVideoToPhotosAlbum({
  filePaths: ['/path/to/video.mp4'],
  usePermission: true,
  callback: (success) => {
    console.log(success ? '保存成功' : '保存失败')
  }
})