更新记录

1.1.0（2026-11-05）

• 首发：基于系统照片选择器（Android Photo Picker / iOS PHPicker）的合规媒体获取。
• 不申请全局相册权限、不静默读取；支持分页多选、原图/压缩、视频导出与缩略图。
• 深度增强：选择结果去重（免费基础能力）、上传前自检与压缩建议（Pro）、缩略图等比适配与懒加载、选择汇总与时长格式化。

平台兼容性

uni-app(4.0)

相册媒体获取·合规版 Pro（zl-gallery-pro）

简介

uni-app 合规相册/媒体获取组件：基于系统照片选择器（Android Photo Picker / iOS PHPicker，经 uni.chooseMedia 调用），不申请全局相册读取权限、不静默读取、不后台访问。支持分页多选、原图/压缩、视频导出与缩略图，返回本机文件路径供业务使用。仅 App 端。

功能特性

• 选择结果去重（免费）：多次打开选择器 / 分页选择，同一文件不再重复入列
• 上传前自检（Pro）：数量、总大小、单文件大小、视频时长四项校验，避免传一半失败
• 压缩建议（Pro）：按超出比例给出质量与长边缩放建议
• 选择汇总与等比缩略图（Pro）：图片/视频数量、总大小、最大文件、缩略图不变形适配
• 系统照片选择器（免相册权限，隐私友好）
• 分页多选图片/视频
• 原图 / 压缩切换
• 视频导出与缩略图
• 返回本机文件路径

平台兼容

App-Android、App-iOS（仅 App；微信小程序可经 uni.chooseMedia 复用同一 API）

快速上手

import { pickMedia } from '@/uni_modules/zl-gallery-pro'
const list = await pickMedia({ mediaType: 'image', count: 9, sizeType: ['compressed'] })
// list: [{ path, type, width, height, size, duration? }]

Android 权限与配置

• 不声明 READ_EXTERNAL_STORAGE / READ_MEDIA_IMAGES 等全局相册权限
• Android 13+(API 33+) 走系统 Photo Picker（无需权限）
• 更低版本仅在选择时由系统授予临时访问
• iOS 14+ 走系统 PHPicker

合规声明

仅在本机调用系统照片选择器、由用户主动选择媒体；不读取、不上传、不缓存用户相册中未被选中的内容。所选文件本机路径仅返回给调用方业务。

常见问题

• Q：为什么要"免权限"？ A：符合最小必要原则，降低隐私合规风险，Android 13+ 与 iOS 14+ 系统选择器原生支持。
• Q：选不了视频？ A：设置 mediaType: 'video' 或 'mix'。

更新说明

1.0.0 首发：系统选择器多选、原图/压缩、视频导出、缩略图。 1.1.0 深度增强：上传前四项自检（数量/总大小/单文件/视频时长）、压缩建议、选择汇总、缩略图懒加载；选择去重免费，自检面板与压缩建议为 Pro。