更新记录

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需要使用源码版才能编译运行

API

saveImageToPhotosAlbum(saveOption)

保存图片到相册，会弹出系统确认对话框，用户确认后将图片保存到相册。

参数说明

文件路径说明

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

示例

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 ? '保存成功' : '保存失败')
  }
})

saveVideoToPhotosAlbum(saveOption)

保存视频到相册，会弹出系统确认对话框，用户确认后将视频保存到相册。

参数说明

文件路径说明

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

示例

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 ? '保存成功' : '保存失败')
        }
      })
    }
  }
})