更新记录

1.0.4（2026-06-09）

修复「原图」显示的文件大小和相册中大小不一致的问题

1.0.3（2026-06-03）

修复

  • 自定义 config 合并改为显式逐字段安全合并：颜色非法 / 数值非有限数时自动回退默认值，不再因非法色值导致崩溃。
  • 修复快速切换相册时可能出现的图片、页码错位等问题。
  • 修复 Android 10（API 29）分区存储下因无法按文件路径访问而导致相册或媒体被整体过滤、列表空白的问题（自动回退 content:// 读取与展示）。
  • 修复「处理中」点击取消导致的重复回调：success / fail / cancel 现严格互斥，complete 不再重复触发。
  • 修复发送失败后重试可能对图片二次压缩的问题。
  • 修复发送过程中切换「原图」开关导致同批文件压缩策略不一致的问题。

优化

  • AndroidManifest 权限合规：READ_EXTERNAL_STORAGE / WRITE_EXTERNAL_STORAGE 增加 maxSdkVersion，新增 READ_MEDIA_VISUAL_USER_SELECTED（Android 14「仅选定照片」）。
  • 优化了一些其他性能问题

新增

  • 新增 MediaConfigOptions 类型：config 参数支持只传需要覆盖的字段，无需传入完整配置对象。

说明

  • 在 Android 10(API 29) 时，建议配置requestLegacyExternalStorage="true"，以获得最佳的相册 / 文件访问兼容性。当然了，不增加该配置也无所谓，插件本身已经有 content:// 回退兜底。
    • uni-app x / 离线打包(自定义基座、本地打包) 直接修改原生工程的 AndroidManifest.xml，在 <application> 标签上加 android:requestLegacyExternalStorage="true"
    • HBuilderX 云打包 一般而言云打包已经带了该配置

1.0.2（2026-06-02）

优化 Android 11(targetSdk≥30) 兼容问题

查看更多

平台兼容性

uni-app(3.99)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android Android插件版本 iOS 鸿蒙
- × × × × - 5.0 1.0.0 × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

uni-app x(3.99)

Chrome Safari Android Android插件版本 iOS 鸿蒙 微信小程序
× × 5.0 1.0.0 × × ×

其他

多语言 暗黑模式 宽屏模式
× × √

l-media

开发文档

UTS 语法 UTS API插件 UTS uni-app兼容模式组件 UTS 标准模式组件 Hello UTS

隐私、权限声明

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

Android 12（API 31）及以下： READ_EXTERNAL_STORAGE -- 用于读取相册中的图片和视频。 WRITE_EXTERNAL_STORAGE -- 插件中有使用缓存，所以Android 9及以下需要写入权限 Android 13（API 33）及以上 READ_MEDIA_IMAGES READ_MEDIA_VIDEO 需要特别注意：本插件需要同时获取媒体权限和文件权限！！！ 有些安卓申请媒体权限的时候会自动获取文件权限，但是有些安卓媒体和文件权限是分开的，所以需要特别注意一下。

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

插件不采集任何数据

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

无

评论列表 撰写评论 向官方投诉
加载更多...