Android 拍照、从相册选择图片之PictureSelect
仿微信实现在Android平台下的图片选择器，支持从相册获取图片、视频、音频&拍照，支持裁剪(单图or多图裁剪)、压缩、主题自定义配置等功能，支持动态获取权限&适配Android 5.0+系统的开源图片选择框架。
效果图奉上
效果图.gif
作者项目地址：https://github.com/LuckSiege/PictureSelector
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.
<repositories><repository><id>jitpack.io</id><url>https://jitpack.io</url></repository></repositories>
step 2.
<dependency><groupId>com.github.LuckSiege.PictureSelector</groupId><artifactId>picture_library</artifactId><version>v2.5.6</version></dependency>
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<LocalMedia> selectList = PictureSelector.obtainMultipleResult(data);
break;
default:
break;
}
}
2、Callback
PictureSelector.create(this)
.openGallery(PictureMimeType.ofAll())
.loadImageEngine(GlideEngine.createGlideEngine())
.forResult(new OnResultCallbackListener<LocalMedia>() {
@Override
public void onResult(List<LocalMedia> 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<LocalMedia> selectList = PictureSelector.obtainMultipleResult(data);
break;
default:
break;
}
}
Callback
PictureSelector.create(this)
.openCamera(PictureMimeType.ofImage())
.loadImageEngine(GlideEngine.createGlideEngine())
.forResult(new OnResultCallbackListener<LocalMedia>() {
@Override
public void onResult(List<LocalMedia> 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<LocalMedia> 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");
}
});
