更新记录

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 后端能力。

隐私说明

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

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<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"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件不主动采集用户隐私数据,不上传任何数据到服务器,不内置服务器地址。 用户选择图片、视频后,插件仅在本机读取用户主动选择的媒体文件,并返回本地文件路径、媒体类型、视频时长、文件大小、 封面路径等业务必要信息。数据用途仅限调用方进行本地预览、编辑、上传或业务处理。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

本插件不内置广告,不接入第三方统计,不主动进行商业化数据采集。插件收费方式以插件市场发布配置为准。

暂无用户评论。