更新记录

1.0.0（2026-06-09）

● 首版发布相册图片、视频选择能力。 ● 支持多选、单图/多图预览、视频预览、原图选择和结果返回。 ● 支持图片编辑，包括涂鸦、文字、裁剪、马赛克。 ● 图片和视频均返回可直接使用的本地文件路径，便于上传和业务预览。

平台兼容性

uni-app(5.07)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	Android插件版本	iOS	鸿蒙	鸿蒙插件版本
-	-	-	-	-	-	5.0	1.0.0	-	API 14+	1.0.0

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
-	-	-	-	-	-	-	-	-	-	-	-

uni-app x(5.07)

Chrome	Safari	Android	Android插件版本	iOS	鸿蒙	鸿蒙插件版本	微信小程序
-	-	5.0	1.0.0	-	API 14+	1.0.0	-

相册图片视频选择预览编辑插件

说明

这是 wsgen-album 的 UTS 主线插件包，目标用于 Android 和 HarmonyOS 相册图片、视频选择能力。

当前 Android 已接入旧 1.0.0 AAR 桥接实现，等待 HBuilderX 真机验证。HarmonyOS 已接入 uni.chooseMedia 系统相册能力作为可运行基线，并新增 ArkTS 原生相册工作台，保持 album(options, callback) API 和旧版返回结构。

引入插件

import { album } from '@/uni_modules/wsgen-album'

调用相册

album({}, result => {
  console.log(result)
})

返回结果

成功时返回媒体数组。为兼容旧 Android 原生插件，数组内每一项是 JSON 字符串：

[
  {
    "format": "img",
    "localPath": "/storage/emulated/0/Android/data/xxx/cache/xxx.jpg"
  }
]

取消或异常时返回：

{
  "event": "cancel",
  "cancel": true,
  "reason": "cancel"
}

Android 权限说明

Android 相册能力目标需要以下权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO"/>
<uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"/>

HarmonyOS 权限说明

HarmonyOS 相册能力需要以下权限：

ohos.permission.READ_IMAGEVIDEO

当前 HarmonyOS 目录已经提供平台入口、权限声明、资源配置、系统相册选择实现和 ArkTS 原生相册工作台。HarmonyOS 端会调用系统相册选择图片/视频并返回媒体结果；同时注册了 wsgen-album-native，第一阶段已覆盖相册宫格、预览、原图、图片编辑、视频编辑和发送事件。后续继续接入 HarmonyOS 媒体库、Image/Video 渲染、PixelMap/Canvas 和 AV 后端能力。

隐私说明

插件不上传数据到服务器，不内置服务器地址，不接入广告或统计。插件只读取用户主动选择的本地媒体，并返回业务必要的本地路径和媒体信息。