仿微信实现在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");
       }

      });

Android 拍照、从相册选择图片之PictureSelector

Android 拍照、从相册选择图片之PictureSelector

单独拍照

结果回调