概述

一款针对Android平台下的图片选择器，支持从相册获取图片、视频、音频&拍照，支持裁剪(单图or多图裁剪)、压缩、主题自定义配置等功能，支持动态获取权限&适配Android 5.0+系统的开源图片选择框架。
支持Uniapp和Uniapp X下的Vue2、VUe3编译，支持所有Android主流操作系统，兼容行可靠稳定

功能说明

下载源码

一. 参数说明

参数	默认值	说明
selectMimeType	0	全部0 图片1 视频1 硬盘3
language	0	系统默认 -1; 简体中文 0; 繁体 1; 英语 2; 韩语 3; 德语 4; 法语 5; 日语 6; 越语 7; 西班牙语 8; 葡萄牙语 9; 阿拉伯语 10; 俄语 11; 捷克 12; 哈萨克斯坦 13;
isCompress	true	是否压缩
isCrop	false	是否剪切
isCameraIntercept	true	是否拦截相机按钮
isCameraForegroundService	true	是否在前台运行
isDisplayCamera	true	是否显示相机
isPageStrategy	true	是否开启分页策略
maxSelectNum	9	最大选择数量
minSelectNum	0	最小选择数量
isVideoPauseResumePlay	true	视频支持暂停与播放
isQuickCapture	true	使用系统摄像机录制后，是否支持使用系统播放器立即播放视频
isPreviewAudio	true	是否支持音频预览
isPreviewImage	true	是否支持预览图片
isPreviewVideo	true	是否支持预览视频
isPreviewFullScreenMode	true	是否支持全屏预览
isEmptyResultReturn	true	是否支持未选择返回
isWithSelectVideoImage	true	是否支持视频图片同选
isSelectZoomAnim	true	选择缩略图缩放效果
isOpenClickSound	true	是否开启点击音效
isCameraAroundState	true	是否开启相机前后切换
isCameraRotateImage	true	拍照是否纠正旋转图片
isGif	true	是否显示gif文件
isWebp	true	是否显示webp文件
isBmp	true	是否显示bmp文件
isMaxSelectEnabledMask	true	达到最大选择数是否开启禁选蒙层
isSyncCover	true	isPageModel模式下是否强制同步封面，默认false
isAutomaticTitleRecyclerTop	true	点击相册标题是否快速回到第一项
isAutoVideoPlay	true	预览视频是否自动播放
isLoopAutoVideoPlay	true	预览视频是否循环播放
isFilterSizeDuration	true	是否过滤图片或音视频大小时长为0的资源
isFastSlidingSelect	true	是否快速滑动选择
isDirectReturnSingle	true	是否直接返回单选
isPageSyncAlbumCount	true	分页模式下设置过滤条件后是否同步专辑下资源的数量
isUseSystemVideoPlayer	true	是否使用系统自带的视频播放器

二. 返回数据说明

返回数据	数据类型	说明
compressed	boolean	是否压缩
compressPath	srtring	压缩路径；设置了isCompress;时返回；
fileName	srtring	文件名
maxSelectEnabledMask	boolean	是否有最大数量限制
num	int	文件数量
bucketId	int
mimeType	srtring	文件类型
duration	int	文件时长
cropResultAspectRatio	int	剪切宽高比
path	srtring	原图path，但在Android Q版本上返回的是content:// Uri类型
checked	boolean	是否选中
realPath	srtring	绝对路径
id	int
toSandboxPath	boolean	是否使用自定义输出路径
sandboxPath	srtring	自定义输出路径
chooseModel	int
width	int	宽度
height	int	高度
original	boolean	是否开启原图
availablePath	srtring
cut	boolean	是否剪切
cutPath	srtring	裁剪后path，设置了isCrop返回
cropImageWidth	int	剪切宽度
cropImageHeight	int	剪切高度
parentFolderName	string
size	int	文件大小
cropOffsetX	int	图片X轴偏移量
cropOffsetY	int	图片Y轴偏移量
galleryEnabledMask	boolean
editorImage	boolean	是否编辑
cameraSource	boolean	是否原图
position	int	位置
dateAddedTime	date	文件添加时间

三.注意事项

从应用市场下载插件导入自己项目后，要先制作自定义插件后，才可以运行使用插件需在 Android 5.0 版本及以上方可正常使用尽量使用 HBuilderX 4.0+ 以上的最新版本，以便更好在uni-app和uni-app x中使用uts插件

2.完整代码示例

<template><view><button @click="openPicture()">打开相册</button><uni-grid :column="4" :highlight="true"><uni-grid-item v-for="(result, index) in resultList" :index="index" :key="index"><view style="background-color: #fff; display: flex; justify-content: center; align-items: center;"><image :src="result.path" mode="aspectFit" :style="{'width': imageSize + 'px', 'height': imageSize + 'px'}"></image></view></uni-grid-item></uni-grid><view style="margin: 10px;"> 返回值：</view><scroll-view scroll-x="true" style="margin:20px; 0px "><y-json-view :json="resultList" closed /></scroll-view></view>
</template><script>import {open} from '@/uni_modules/pic-selector'const modal = uni.requireNativePlugin('modal');export default {data() {return {imageSize:uni.getSystemInfoSync().windowWidth/4-10,resultList:[// {//     "compressed": true,//是否压缩//     "compressPath": "",//压缩路径；设置了isCompress;时返回；//     "fileName": "",//文件名//     "maxSelectEnabledMask": false,//     "num": 1,//文件数量//     "bucketId": -643270046,//     "mimeType": "image/jpeg",//文件类型//     "duration": 0,//文件时长//     "cropResultAspectRatio": 1,//     "path": "",//原图path，但在Android Q版本上返回的是content:// Uri类型//     "checked": false,//     "realPath": "",//绝对路径//     "id": 13043,//     "toSandboxPath": true,//是否使用自定义输出路径//     "sandboxPath": "",//自定义输出路径//     "chooseModel": 0,//     "width": 1134,//宽度//     "height": 1780,//高度//     "original": false,//是否开启原图//     "availablePath": "",//     "cut": true,//是否剪切//     "cutPath": "",//裁剪后path，设置了isCrop返回//     "cropImageWidth": 567,//剪切宽度//     "cropImageHeight": 567,//剪切高度//     "parentFolderName": "WeiXin",//     "size": 392774,//文件大小//     "cropOffsetX": 0,//图片X轴偏移量//     "cropOffsetY": 162,//图片Y轴偏移量//     "galleryEnabledMask": false,//     "editorImage": false,//     "cameraSource": false,//     "position": 1,//     "dateAddedTime": 1749993134// }]}},methods: {openPicture(){let _this = thislet params = {selectMimeType:0,//全部0 图片1 视频1 硬盘3language:0, //system Language -1; 简体中文  0; 繁体 1; 英语 2;  韩语 3; 德语 4; 法语 5; 日语 6; 越语 7;  西班牙语 8; 葡萄牙语 9; 阿拉伯语 10; 俄语 11; 捷克 12; 哈萨克斯坦 13;isCompress:true,//是否压缩isCrop:false,//是否剪切isCameraIntercept :true,//是否拦截相机按钮isCameraForegroundService:true,//是否在前台运行isDisplayCamera:true,//是否显示相机isPageStrategy:true,//是否开启分页策略maxSelectNum:99,//最大选择数量minSelectNum:0,//最小选择数量isVideoPauseResumePlay:true,//视频支持暂停与播放isQuickCapture:true,//使用系统摄像机录制后，是否支持使用系统播放器立即播放视频isPreviewAudio:true,//是否支持音频预览isPreviewImage:true,//是否支持预览图片isPreviewVideo:true,//是否支持预览视频isPreviewFullScreenMode:true,//是否支持全屏预览isEmptyResultReturn:true,//是否支持未选择返回isWithSelectVideoImage:true,//是否支持视频图片同选isSelectZoomAnim:true, //选择缩略图缩放效果isOpenClickSound:true,//是否开启点击音效isCameraAroundState:true,//是否开启相机前后切换isCameraRotateImage:true,//拍照是否纠正旋转图片isGif:true,//是否显示gif文件isWebp:true, //是否显示webp文件isBmp:true,//是否显示bmp文件isMaxSelectEnabledMask:true,//达到最大选择数是否开启禁选蒙层isSyncCover:true, //isPageModel模式下是否强制同步封面，默认falseisAutomaticTitleRecyclerTop:true,//点击相册标题是否快速回到第一项isAutoVideoPlay:true,//预览视频是否自动播放isLoopAutoVideoPlay:true,//预览视频是否循环播放isFilterSizeDuration:true,//是否过滤图片或音视频大小时长为0的资源isFastSlidingSelect:true,//是否快速滑动选择isDirectReturnSingle:true,//是否直接返回单选isPageSyncAlbumCount:true,//分页模式下设置过滤条件后是否同步专辑下资源的数量isUseSystemVideoPlayer:true,//是否使用系统自带的视频播放器}open(params,{onResult(result){if(result){_this.resultList = JSON.parse(result)console.log('onResult--->>',result)modal.toast({ message: _this.resultList, duration: 1.5 });}},onCancel(){console.log('onCancel--->>',result)}})}}}
</script><style>
</style>

长期维护，持续更新，对付费用户提供终身免费技术支持