YImagePicker: A Java repository from xuxiaoguang

关于YImagePicker

支持无缝切换小红书剪裁样式并自定义UI
支持微信、马蜂窝、知乎等多个不同风格样式定制
支持图片直接预览和编辑预览（排序、删除）
支持单图自定义比例剪裁
支持单图圆形剪裁，生成png圆形图片(2.4.3版本加入)
支持13种视频图片文件类型混合加载(2.4.4版本加入)
支持高清预览超长图、超大图，图片放大效果胜过微信
小红书剪裁样式支持视频预览
支持图片和视频文件混合选择或指定类型选择
微信样式支持多次选择状态保存
微信样式支持指定某些媒体文件不可选择
选择结果直接回调，拒绝配置ActivityForResult+requestCode，即调用即处理
支持选择器调用失败回调(2.4.4版本加入)
轻量级，aar大小不超过300K，无so库，无任何第三方依赖
支持androidx和support
永久维护

引入依赖

androidx版本：

implementation 'com.ypx.yimagepicker:androidx:2.4.4'

support版本：

implementation 'com.ypx.yimagepicker:support:2.4.4'

核心原理

YImagePicker与主项目通过presenter进行交互与解耦，presenter采用序列化接口的方式实现。回调采用嵌入fragment的方式实现，类似于Glide或RxPermisson.原理上还是使用OnActivityResult,但无需再配置requestCode并且支持跨进程回调。

小红书样式需要实现：ICropPickerBindPresenter 微信样式需要实现：IMultiPickerBindPresenter

点击查看详细API文档

apk体验地址

效果图集

demo效果

小红书样式

微信样式

自定义样式

自定义比例剪裁

点击查看详细API文档

微信图片选择

支持视频、GIF、长图选择，支持选择状态保存。调用前请按照demo实现IMultiPickerBindPresenter接口

调用示例：

ImagePicker.withMulti(new WXImgPickerPresenter())//指定presenter
           .setMaxCount(9)//设置选择的最大数
           .setColumnCount(4)//设置列数
           .mimeType(MimeType.ofAll())//设置要加载的文件类型，可指定单一类型
           .filterMimeType(MimeType.GIF)//设置需要过滤掉加载的文件类型
           .showCamera(true)//显示拍照
           .setPreview(true)//开启预览
           .setVideoSinglePick(true)//设置视频单选
           .setSinglePickImageOrVideoType(true)//设置图片和视频单一类型选择
           .setMaxVideoDuration(120000L)//设置视频可选取的最大时长
           .setLastImageList(null)//设置上一次操作的图片列表，下次选择时默认恢复上一次选择的状态
           .setShieldList(null)//设置需要屏蔽掉的图片列表，下次选择时已屏蔽的文件不可选择
           .pick(this, new OnImagePickCompleteListener() {
                @Override
                public void onImagePickComplete(ArrayList<ImageItem> items) {
                    //图片选择回调，主线程
                }
            });

小红书图片选择

高仿小红书图片剪裁框架，支持视频以及多图剪裁、支持视频预览，支持UI自定义，支持fragment样式侵入。调用前请按照demo实现ICropPickerBindPresenter接口

调用示例：

ImagePicker.withCrop(new RedBookCropPresenter())//设置presenter
           .setMaxCount(9)//设置选择数量
           .showCamera(true)//设置显示拍照
           .setColumnCount(4)//设置列数
           .mimeType(MimeType.ofImage())//设置需要加载的文件类型
           .filterMimeType(MimeType.GIF)//设置需要过滤掉的文件类型
           .setFirstImageItem(null)//设置上一次选中的图片
           .setFirstImageUrl(null)//设置上一次选中的图片地址
           .setVideoSinglePick(true)//设置视频单选
           .setCropPicSaveFilePath("剪裁图片保存路径")
           .setMaxVideoDuration(2000L)//设置可选区的最大视频时长
           .pick(this, new OnImagePickCompleteListener() {
                @Override
                public void onImagePickComplete(ArrayList<ImageItem> items) {
                    //图片剪裁回调，主线程
                    //注意：剪裁回调里的ImageItem中getCropUrl()才是剪裁过后的图片地址
                }
            });

单图剪裁

支持选择图片完调用剪裁，支持自定义比例剪裁，支持圆形剪裁

调用示例：

ImagePicker.withMulti(new WXImgPickerPresenter())
           .mimeType(MimeType.ofImage())
           .filterMimeType(MimeType.GIF)
           .setCropRatio(1,1)//设置剪裁比例
           .cropSaveFilePath("剪裁图片保存路径")
           .cropRectMinMargin(50)//设置剪裁框间距，单位px
           .cropAsCircle()//圆形剪裁
           .crop(this, new OnImagePickCompleteListener() {
               @Override
               public void onImagePickComplete(ArrayList<ImageItem> items) {
                   //图片剪裁回调，主线程
               }
           });

预览

支持普通预览和编辑预览

调用示例：

//配置需要预览的所有图片列表
ArrayList<ImageItem> allPreviewImageList = new ArrayList<>();
//默认选中的图片索引
int defaultPosition = 0;
//开启编辑预览
ImagePicker.preview(this, new WXImgPickerPresenter(), allPreviewImageList, defaultPosition, new OnImagePickCompleteListener() {
        @Override
        public void onImagePickComplete(ArrayList<ImageItem> items) {
            //图片编辑回调，主线程
        }
    });

直接拍照

支持直接打开摄像头拍照

调用示例：

ImagePicker.takePhoto(this, "拍照保存路径", new OnImagePickCompleteListener() {
            @Override
            public void onImagePickComplete(ArrayList<ImageItem> items) {
                //拍照回调，主线程
            }
        });

直接拍照并剪裁

支持直接打开摄像头拍照并剪裁，支持自定义比例剪裁和圆形剪裁

调用示例：

//配置剪裁属性
MultiSelectConfig selectConfig = new MultiSelectConfig();
selectConfig.setCropRatio(1, 1);//设置剪裁比例
selectConfig.setCropRectMargin(50);//设置剪裁框间距，单位px
selectConfig.setCropSaveFilePath("剪裁图片保存路径");
selectConfig.setCircle(false);//是否圆形剪裁
ImagePicker.takePhotoAndCrop(this, new WXImgPickerPresenter(), selectConfig, new OnImagePickCompleteListener() {
    @Override
    public void onImagePickComplete(ArrayList<ImageItem> items) {
            //剪裁回调，主线程
        }
    });

设置选择器调用失败回调

所有OnImagePickCompleteListener回调都可以设置OnImagePickCompleteListener2监听

调用示例：

ImagePicker.withMulti(new WXImgPickerPresenter())
            //...省略若干属性
            .pick(new OnImagePickCompleteListener2() {
                 @Override
                public void onPickFailed(PickerError error) {
                    //调用选择器失败回调
                }

                @Override
                public void onImagePickComplete(ArrayList<ImageItem> items) {
                    //图片选择回调，主线程
                }
            })

以上只是简单代码示例，详细功能请 查看详细API文档

版本记录

查看详细版本记录

2.4.4版本 [2019.10.18]

【BUG修复】修复了预览时无法排序问题
【新增】支持十三种图片视频文件混合或指定选择，调用方法mimeType()和filterMimeType()
【新增】支持直接调用拍照和直接调用拍照并剪裁图片
【新增】支持选择器调用失败或取消选择回调，使用OnImagePickCompleteListener2
【新增】小红书剪裁支持配置状态栏是否显示
【新增】小红书剪裁支持定制标题下箭头
【去除】去除showImage()、showVideo()、showGif()三个方法，统一使用mimeType()和filterMimeType()
【去除】去除原有预览和拍照方法，全部采用ImagePicker.takePhoto()
【优化】预览页面重构，支持编辑预览和普通预览
【优化】优化拍照逻辑，去除PTakePhoto类

下个版本排期

时间：2019年12月左右

视频预览框架切换（吐槽：官方videoView太难用了~~/(ㄒoㄒ)/~~）
图片剪裁支持旋转
~~支持JPEG、PNG、GIF、BMP、WEBP、MPEG、MP4、QUICKTIME、THREEGPP、THREEGPP2、MKV、WEBM、TS、AVI等图片视频文件格式混合加载或指定加载~~（2.4.4已支持）
等你来提

本库来源于mars App,想要体验城市最新的吃喝玩乐，欢迎读者下载体验mars!

作者：calorYang 邮箱：313930500@qq.com Q Q: 313930500 微信：calor0616 博客：CSDN

遇到问题别绕路，QQ微信直接呼~ 您的star就是我前进的动力~🌹

xuxiaoguang/YImagePicker

关于YImagePicker

引入依赖

核心原理

效果图集

点击查看详细API文档

微信图片选择

小红书图片选择

单图剪裁

预览

直接拍照

直接拍照并剪裁

设置选择器调用失败回调

版本记录

2.4.4版本 [2019.10.18]

下个版本排期