仿微信实现在Android平台下的图片选择器，支持从相册获取图片、视频、音频&拍照，支持裁剪(单图or多图裁剪)、压缩、主题自定义配置等功能，支持动态获取权限&适配Android 5.0+系统的开源图片选择框架。

效果图奉上

效果图.gif

Api介绍说明：

功能特点：

1.适配Android5.0+ &Android Q系统

2.解决部分机型裁剪闪退问题

3.解决图片过大oom闪退问题

4.动态获取系统权限，避免闪退

5.支持相片or视频的单选和多选

6.支持裁剪比例设置，如常用的 1:1、3：4、3:2、16:9 默认为图片大小

7.支持视频预览

8.支持gif图片

9.支持.webp格式图片

10.支持一些常用场景设置：如:是否裁剪、是否预览图片、是否显示相机等

11.新增自定义主题设置

12.新增图片勾选样式设置

13.新增图片裁剪宽高设置

14.新增图片压缩处理

15.新增录视频最大时间设置

16.新增视频清晰度设置

17.新增QQ选择风格，带数字效果

18.新增自定义 文字颜色 背景色让风格和项目更搭配

19.新增多图裁剪功能

20.新增LuBan多图压缩

21.新增单独拍照功能

22.新增压缩大小设置

23.新增Luban压缩档次设置

24.新增圆形头像裁剪

25.新增音频功能查询

26.新增可自定义启动相册动画 forResult(int requestCode, int enterAnim, int exitAnim);

27.新增指定精确查询 querySpecifiedFormatSuffix(PictureMimeType.ofPNG())// 查询指定后缀格式资源

28.新增单选模式可设置点击选择后直接返回控制 isSingleDirectReturn(false)// 单选模式下是否直接返回

29.多图裁剪下可自由选择某图不裁剪不在强制一张张裁剪，但最后一张除外

30.新增动态配制相册主题 .setPictureStyle(mPictureParameterStyle); 请参考Demo

31.新增动态配制裁剪主题 .setPictureCropStyle(mCropParameterStyle); 请参考Demo

32.新增自定义相册启动退出动画 .setPictureWindowAnimationStyle(windowAnimationStyle); 请参考Demo

33.新增原图功能

34.新增全新相册主题风格，类似新版微信相册样式

35.新增繁体、韩语、德语、法语、日语语言包，可通过api .setLanguage(language);进行设置

....

最新版本：

implementation'com.github.LuckSiege.PictureSelector:picture_library:v2.5.6'

集成方式：

build gradle implementation

dependencies {

implementation'com.github.LuckSiege.PictureSelector:picture_library:v2.5.6'

}

project root build.gradle add

allprojects {

repositories {

jcenter()

maven { url 'https://jitpack.io' }

}

}

maven

step 1.

jitpack.iohttps://jitpack.io

step 2.

com.github.LuckSiege.PictureSelectorpicture_libraryv2.5.6

Api介绍说明：

PictureSelector.create(this)

.openGallery()//相册 媒体类型 PictureMimeType.ofAll()、ofImage()、ofVideo()、ofAudio()

//.openCamera()//单独使用相机 媒体类型 PictureMimeType.ofImage()、ofVideo()

.theme()// xml样式配制 R.style.picture_default_style、picture_WeChat_style or 更多参考Demo

.loadImageEngine()// 图片加载引擎 需要 implements ImageEngine接口

.selectionMode()//单选or多选 PictureConfig.SINGLE PictureConfig.MULTIPLE

.isPageStrategy()//开启分页模式，默认开启另提供两个参数；pageSize每页总数；isFilterInvalidFile是否过滤损坏图片

.isSingleDirectReturn()//PictureConfig.SINGLE模式下是否直接返回

.isWeChatStyle()//开启R.style.picture_WeChat_style样式

.setPictureStyle()//动态自定义相册主题

.setPictureCropStyle()//动态自定义裁剪主题

.setPictureWindowAnimationStyle()//相册启动退出动画

.isCamera()//列表是否显示拍照按钮

.isZoomAnim()//图片选择缩放效果

.imageFormat()//拍照图片格式后缀,默认jpeg, PictureMimeType.PNG，Android Q使用PictureMimeType.PNG_Q

.maxSelectNum()//最大选择数量,默认9张

.minSelectNum()// 最小选择数量

.maxVideoSelectNum()//视频最大选择数量

.minVideoSelectNum()//视频最小选择数量

.videoMaxSecond()// 查询多少秒以内的视频

.videoMinSecond()// 查询多少秒以内的视频

.imageSpanCount()//列表每行显示个数

.openClickSound()//是否开启点击声音

.selectionMedia()//是否传入已选图片

.recordVideoSecond()//录制视频秒数 默认60s

.previewEggs()//预览图片时是否增强左右滑动图片体验

.cropCompressQuality()// 注：已废弃 改用cutOutQuality()

.isGif()//是否显示gif

.previewImage()//是否预览图片

.previewVideo()//是否预览视频

.enablePreviewAudio()//是否预览音频

.enableCrop()//是否开启裁剪

.cropWH()// 裁剪宽高比,已废弃，改用. cropImageWideHigh()方法

.cropImageWideHigh()// 裁剪宽高比，设置如果大于图片本身宽高则无效

.withAspectRatio()//裁剪比例

.cutOutQuality()// 裁剪输出质量 默认100

.freeStyleCropEnabled()//裁剪框是否可拖拽

.circleDimmedLayer()// 是否开启圆形裁剪

.setCircleDimmedColor()//设置圆形裁剪背景色值

.setCircleDimmedBorderColor()//设置圆形裁剪边框色值

.setCircleStrokeWidth()//设置圆形裁剪边框粗细

.showCropFrame()// 是否显示裁剪矩形边框 圆形裁剪时建议设为false

.showCropGrid()//是否显示裁剪矩形网格 圆形裁剪时建议设为false

.rotateEnabled()//裁剪是否可旋转图片

.scaleEnabled()//裁剪是否可放大缩小图片

.isDragFrame()//是否可拖动裁剪框(固定)

.hideBottomControls()//显示底部uCrop工具栏

.basicUCropConfig()//对外提供ucrop所有的配制项

.compress()//是否压缩

.compressFocusAlpha()//压缩后是否保持图片的透明通道

.minimumCompressSize()// 小于多少kb的图片不压缩

.videoQuality()//视频录制质量 0 or 1

.compressQuality()//图片压缩后输出质量

.synOrAsy()//开启同步or异步压缩

.queryMaxFileSize()//查询指定大小内的图片、视频、音频大小，单位M

.compressSavePath()//自定义压缩图片保存地址，注意Q版本下的适配

.sizeMultiplier()//glide加载大小，已废弃

.glideOverride()//glide加载宽高，已废弃

.isMultipleSkipCrop()//多图裁剪是否支持跳过

.isMultipleRecyclerAnimation()// 多图裁剪底部列表显示动画效果

.querySpecifiedFormatSuffix()//只查询指定后缀的资源，PictureMimeType.ofJPEG() ...

.isReturnEmpty()//未选择数据时按确定是否可以退出

.isAndroidQTransform()//Android Q版本下是否需要拷贝文件至应用沙盒内

.setRequestedOrientation()//屏幕旋转方向 ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED ...

.isOriginalImageControl()//开启原图选项

.bindCustomPlayVideoCallback()//自定义视频播放拦截

.bindCustomCameraInterfaceListener()//自定义拍照回调接口

.cameraFileName()//自定义拍照文件名，如果是相册内拍照则内部会自动拼上当前时间戳防止重复

.renameCompressFile()//自定义压缩文件名，多张压缩情况下内部会自动拼上当前时间戳防止重复

.renameCropFileName()//自定义裁剪文件名，多张裁剪情况下内部会自动拼上当前时间戳防止重复

.setRecyclerAnimationMode()//列表动画效果,AnimationType.ALPHA_IN_ANIMATION、SLIDE_IN_BOTTOM_ANIMATION

.isUseCustomCamera()// 开启自定义相机

.setButtonFeatures()// 自定义相机按钮状态,CustomCameraView.BUTTON_STATE_BOTH

.setLanguage()//国际化语言 LanguageConfig.CHINESE、ENGLISH、JAPAN等

.isWithVideoImage()//图片和视频是否可以同选,只在ofAll模式下有效

.isMaxSelectEnabledMask()//选择条件达到阀时列表是否启用蒙层效果

.isAutomaticTitleRecyclerTop()//图片列表超过一屏连续点击顶部标题栏快速回滚至顶部

.loadCacheResourcesCallback()//获取ImageEngine缓存图片，参考Demo

.setOutputCameraPath()// 自定义相机输出目录只针对Android Q以下版本，具体参考Demo

.forResult();//结果回调分两种方式onActivityResult()和OnResultCallbackListener方式。

快速使用：

启动相册

1、onActivityResult

PictureSelector.create(this)

.openGallery(PictureMimeType.ofImage())

.loadImageEngine(GlideEngine.createGlideEngine()) // 请参考Demo

GlideEngine.java

.forResult(PictureConfig.CHOOSE_REQUEST);

@Override

protected void onActivityResult(int requestCode, int resultCode, Intent data){

super.onActivityResult(requestCode, resultCode, data);

if (resultCode == RESULT_OK) {

switch (requestCode) {

case PictureConfig.CHOOSE_REQUEST:

// 结果回调

List selectList = PictureSelector.obtainMultipleResult(data);

break;

default:

break;

}

}

2、Callback

PictureSelector.create(this)

.openGallery(PictureMimeType.ofAll())

.loadImageEngine(GlideEngine.createGlideEngine())

.forResult(new OnResultCallbackListener() {

@Override

public void onResult(List result) {

// 结果回调

}

@Override

public void onCancel() {

// 取消

}

});

单独拍照

快捷调用，单独启动拍照或视频 根据PictureMimeType自动识别 更多功能 请查看

onActivityResult

PictureSelector.create(this)

.openCamera(PictureMimeType.ofImage())

.loadImageEngine(GlideEngine.createGlideEngine()) // 请参考Demo GlideEngine.java

.forResult(PictureConfig.REQUEST_CAMERA);

@Override

protected void onActivityResult(int requestCode, int resultCode, Intent data) {

super.onActivityResult(requestCode, resultCode, data);

if (resultCode == RESULT_OK) {

switch (requestCode) {

case PictureConfig.REQUEST_CAMERA:

// 结果回调

List selectList = PictureSelector.obtainMultipleResult(data);

break;

default:

break;

}

}

Callback

PictureSelector.create(this)

.openCamera(PictureMimeType.ofImage())

.loadImageEngine(GlideEngine.createGlideEngine())

.forResult(new OnResultCallbackListener() {

@Override

public void onResult(List result) {

// 结果回调

}

@Override

public void onCancel() {

// 取消

}

});

结果回调

@Override

protected void onActivityResult(int requestCode, int resultCode, Intent data) {

super.onActivityResult(requestCode, resultCode, data);

if (resultCode == RESULT_OK) {

switch (requestCode) {

case PictureConfig.CHOOSE_REQUEST:

// 图片选择结果回调

selectList = PictureSelector.obtainMultipleResult(data);

// 例如 LocalMedia 里面返回五种path

// 1.media.getPath(); 原图path，但在Android Q版本上返回的是content:// Uri类型

// 2.media.getCutPath();裁剪后path，需判断media.isCut();切勿直接使用

// 3.media.getCompressPath();压缩后path，需判断media.isCompressed();切勿直接使用

// 4.media.getOriginalPath()); media.isOriginal());为true时此字段才有值

// 5.media.getAndroidQToPath();Android Q版本特有返回的字段，但如果开启了压缩或裁剪还是取裁剪或压缩路

径；注意：.isAndroidQTransform(false);此字段将返回空

// 如果同时开启裁剪和压缩，则取压缩路径为准因为是先裁剪后压缩

for (LocalMedia media : selectList) {

Log.i(TAG, "压缩::" + media.getCompressPath());

Log.i(TAG, "原图::" + media.getPath());

Log.i(TAG, "裁剪::" + media.getCutPath());

Log.i(TAG, "是否开启原图::" + media.isOriginal());

Log.i(TAG, "原图路径::" + media.getOriginalPath());

Log.i(TAG, "Android Q 特有Path::" + media.getAndroidQToPath());

// TODO 可以通过PictureSelectorExternalUtils.getExifInterface();方法获取一些额外的资源信息，

如旋转角度、经纬度等信息

}

break;

}

}

}

// 从v2.4.5开始新增 Callback回调方式返回结果...

.forResult(new OnResultCallbackListener() {

@Override

public void onResult(List result) {

// 例如 LocalMedia 里面返回五种path

// 1.media.getPath(); 原图path，但在Android Q版本上返回的是content:// Uri类型

// 2.media.getCutPath();裁剪后path，需判断media.isCut();切勿直接使用

// 3.media.getCompressPath();压缩后path，需判断media.isCompressed();切勿直接使用

// 4.media.getOriginalPath()); media.isOriginal());为true时此字段才有值

// 5.media.getAndroidQToPath();Android Q版本特有返回的字段，但如果开启了压缩或裁剪还是取裁剪或压缩路

径；注意：.isAndroidQTransform(false);此字段将返回空

// 如果同时开启裁剪和压缩，则取压缩路径为准因为是先裁剪后压缩

// TODO 可以通过PictureSelectorExternalUtils.getExifInterface();方法获取一些额外的资源信息，

如旋转角度、经纬度等信息

for (LocalMedia media : result) {

Log.i(TAG, "是否压缩:" + media.isCompressed());

Log.i(TAG, "压缩:" + media.getCompressPath());

Log.i(TAG, "原图:" + media.getPath());

Log.i(TAG, "是否裁剪:" + media.isCut());

Log.i(TAG, "裁剪:" + media.getCutPath());

Log.i(TAG, "是否开启原图:" + media.isOriginal());

Log.i(TAG, "原图路径:" + media.getOriginalPath());

Log.i(TAG, "Android Q 特有Path:" + media.getAndroidQToPath());

}

}

@Override

public void onCancel() {

Log.i(TAG, "PictureSelector Cancel");

}

});