Android——UI篇：Android(安卓)图片选择器PictureSelector

一、功能介绍：

功能特点：
1.适配 android7.0 系统
2.解决部分机型裁剪闪退问题
4.解决图片过大 oom 闪退问题
5.动态获取系统权限，避免闪退
6.支持相片 or 视频的单选和多选
7.支持裁剪比例设置，如常用的 1:1、3：4、3:2、16:9 默认为图片大小
8.支持视频预览
9.支持 gif 图片
10.支持一些常用场景设置：如:是否裁剪、是否预览图片、是否裁剪、是否显示相机等

二、android studio中使用：

1、添加权限

注：适配 android6.0 以上拍照问题，请在 AndroidManifest.xml 中添加如下代码：

2、添加依赖

compile 'com.github.LuckSiege.PictureSelector:picture_library:v2.1.0'

然后再项目的根目录的build.gride中添加：

allprojects {   repositories {      jcenter()      maven { url 'https://jitpack.io' }   }}

3、代码中使用：

// 进入相册 以下是例子：用不到的 api 可以不写 PictureSelector.create(MainActivity.this)     .openGallery()//全部.PictureMimeType.ofAll()、图片.ofImage()、视频.ofVideo()     .theme()//主题样式(不设置为默认样式) 也可参考 demo values/styles 下 例如：R.style.picture.white.style     .maxSelectNum()// 最大图片选择数量 int     .minSelectNum()// 最小选择数量 int    .imageSpanCount(4)// 每行显示个数 int     .selectionMode()// 多选 or 单选 PictureConfig.MULTIPLE or PictureConfig.SINGLE     .previewImage()// 是否可预览图片 true or false     .previewVideo()// 是否可预览视频 true or false    .enablePreviewAudio() // 是否可播放音频 true or false     .compressGrade()// luban 压缩档次，默认 3 档 Luban.THIRD_GEAR、Luban.FIRST_GEAR、Luban.CUSTOM_GEAR     .isCamera()// 是否显示拍照按钮 true or false    .isZoomAnim(true)// 图片列表点击 缩放效果 默认 true    .sizeMultiplier(0.5f)// glide 加载图片大小 0~1 之间 如设置 .glideOverride()无效    .setOutputCameraPath("/CustomPath")// 自定义拍照保存路径,可不填     .enableCrop()// 是否裁剪 true or false     .compress()// 是否压缩 true or false     .compressMode()//系统自带 or 鲁班压缩 PictureConfig.SYSTEM_COMPRESS_MODE or LUBAN_COMPRESS_MODE     .glideOverride()// int glide 加载宽高，越小图片列表越流畅，但会影响列表图片浏览的清晰度     .withAspectRatio()// int 裁剪比例 如 16:9 3:2 3:4 1:1 可自定义     .hideBottomControls()// 是否显示 uCrop 工具栏，默认不显示 true or false     .isGif()// 是否显示 gif 图片 true or false     .freeStyleCropEnabled()// 裁剪框是否可拖拽 true or false     .circleDimmedLayer()// 是否圆形裁剪 true or false     .showCropFrame()// 是否显示裁剪矩形边框 圆形裁剪时建议设为 false   true or false     .showCropGrid()// 是否显示裁剪矩形网格 圆形裁剪时建议设为 false    true or false     .openClickSound()// 是否开启点击声音 true or false     .selectionMedia()// 是否传入已选图片 List list     .previewEggs()// 预览图片时 是否增强左右滑动图片体验(图片滑动一半即可看到上一张是否选中) true or false     .cropCompressQuality()// 裁剪压缩质量 默认 90 int     .compressMaxKB()//压缩最大值 kb compressGrade()为 Luban.CUSTOM_GEAR 有效 int      .compressWH() // 压缩宽高比 compressGrade()为 Luban.CUSTOM_GEAR 有效  int      .cropWH()// 裁剪宽高比，设置如果大于图片本身宽高则无效 int      .rotateEnabled() // 裁剪是否可旋转图片 true or false     .scaleEnabled()// 裁剪是否可放大缩小图片 true or false     .videoQuality()// 视频录制质量 0 or 1 int     .videoSecond()// 显示多少秒以内的视频 or 音频也可适用 int     .recordVideoSecond()//视频秒数录制 默认 60s int     .forResult(PictureConfig.CHOOSE_REQUEST);//结果回调 onActivityResult code

记得要在上传完图片后调用，清理缓存:

 //包括裁剪和压缩后的缓存，要在上传成功后调用，注意：需要系统 sd 卡权限  PictureFileUtils.deleteCacheDirFile(MainActivity.this);

4、主题配置：

5、常用功能：

启动相册、拍照：

 PictureSelector.create(MainActivity.this)       .openGallery(PictureMimeType.ofImage())       .forResult(PictureConfig.CHOOSE_REQUEST);

单独启动拍照或视频根据 PictureMimeType 自动识别：

PictureSelector.create(MainActivity.this)       .openCamera(PictureMimeType.ofImage())       .forResult(PictureConfig.CHOOSE_REQUEST);

预览图片：

// 预览图片 可自定长按保存路径PictureSelector.create(MainActivity.this).externalPicturePreview(position, "/custom_file", selectList);PictureSelector.create(MainActivity.this).externalPicturePreview(position, selectList);

预览视频：

PictureSelector.create(MainActivity.this).externalPictureVideo(video_path);

结果回调：

@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                    // 2.media.getCutPath();为裁剪后 path，需判断 media.isCut();是否为 true                    // 3.media.getCompressPath();为压缩后 path，需判断 media.isCompressed();是否为 true                    // 如果裁剪并压缩了，以取压缩路径为准，因为是先裁剪后压缩的                    adapter.setList(selectList);                    adapter.notifyDataSetChanged();                    DebugUtil.i(TAG, "onActivityResult:" + selectList.size());                    break;            }        }    }

6、混淆配置：

#PictureSelector 2.0-keep class com.luck.picture.lib.** { *; }-dontwarn com.yalantis.ucrop**-keep class com.yalantis.ucrop** { *; }-keep interface com.yalantis.ucrop** { *; } #rxjava-dontwarn sun.misc.**-keepclassmembers class rx.internal.util.unsafe.*ArrayQueue*Field* { long producerIndex; long consumerIndex;}-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueProducerNodeRef { rx.internal.util.atomic.LinkedQueueNode producerNode;}-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueConsumerNodeRef { rx.internal.util.atomic.LinkedQueueNode consumerNode;}#rxandroid-dontwarn sun.misc.**-keepclassmembers class rx.internal.util.unsafe.*ArrayQueue*Field* {   long producerIndex;   long consumerIndex;}-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueProducerNodeRef {    rx.internal.util.atomic.LinkedQueueNode producerNode;}-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueConsumerNodeRef {    rx.internal.util.atomic.LinkedQueueNode consumerNode;}#glide-keep public class * implements com.bumptech.glide.module.GlideModule-keep public class * extends com.bumptech.glide.AppGlideModule-keep public enum com.bumptech.glide.load.resource.bitmap.ImageHeaderParser$** {  **[] $VALUES;  public *;}# for DexGuard only-keepresourcexmlelements manifest/application/meta-data@value=GlideModule

项目中需要第三方库的支持：

glide:4.0.0 RC1
rxjava:2.0.5
rxandroid:2.0.1
PhotoView:1.2.4
luban
裁剪使用 ucrop

下面附上原文地址：
http://p.codekk.com/detail/Android/LuckSiege/PictureSelector

下面附上项目的github地址：

https://github.com/LuckSiege/PictureSelector

更多相关文章

随机推荐