第三方库之 PictureSelector

2021-12-13 本文已影响0人 Kevin_小飞象

每日一图.jpg

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

目前最新的版本是v2.7.3。
GitHub：PictureSelector

效果图

29.png

功能

适配android6.0+系统
解决部分机型裁剪闪退问题
解决图片过大oom闪退问题
动态获取系统权限，避免闪退
支持相片or视频的单选和多选
支持裁剪比例设置，如常用的 1:1、3：4、3:2、16:9 默认为图片大小
支持视频预览
支持gif图片
支持.webp格式图片
支持一些常用场景设置：如:是否裁剪、是否预览图片、是否显示相机等
新增自定义主题设置
新增图片勾选样式设置
新增图片裁剪宽高设置
新增图片压缩处理
新增录视频最大时间设置
新增视频清晰度设置
新增QQ选择风格，带数字效果
新增自定义文字颜色背景色让风格和项目更搭配
新增多图裁剪功能
新增LuBan多图压缩
新增单独拍照功能
新增压缩大小设置
新增Luban压缩档次设置
新增圆形头像裁剪
新增音频功能查询

主题配置

<!--默认样式 注意* 样式只可修改，不能删除任何一项 否则报错-->
    <style name="picture.default.style" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->
        <!--标题栏背景色-->
        <item name="colorPrimary">@color/bar_grey</item>
        <!--状态栏背景色-->
        <item name="colorPrimaryDark">@color/bar_grey</item>
        <!--是否改变图片列表界面状态栏字体颜色为黑色-->
        <item name="picture.statusFontColor">false</item>
        <!--返回键图标-->
        <item name="picture.leftBack.icon">@drawable/picture_back</item>
        <!--标题下拉箭头-->
        <item name="picture.arrow_down.icon">@drawable/arrow_down</item>
        <!--标题上拉箭头-->
        <item name="picture.arrow_up.icon">@drawable/arrow_up</item>
        <!--标题文字颜色-->
        <item name="picture.title.textColor">@color/white</item>
        <!--标题栏右边文字-->
        <item name="picture.right.textColor">@color/white</item>
        <!--图片列表勾选样式-->
        <item name="picture.checked.style">@drawable/checkbox_selector</item>
        <!--开启图片列表勾选数字模式-->
        <item name="picture.style.checkNumMode">false</item>
        <!--选择图片样式0/9-->
        <item name="picture.style.numComplete">false</item>
        <!--图片列表底部背景色-->
        <item name="picture.bottom.bg">@color/color_fa</item>
        <!--图片列表预览文字颜色-->
        <item name="picture.preview.textColor">@color/tab_color_true</item>
        <!--图片列表已完成文字颜色-->
        <item name="picture.complete.textColor">@color/tab_color_true</item>
        <!--图片已选数量圆点背景色-->
        <item name="picture.num.style">@drawable/num_oval</item>
        <!--预览界面标题文字颜色-->
        <item name="picture.ac_preview.title.textColor">@color/white</item>
        <!--预览界面已完成文字颜色-->
        <item name="picture.ac_preview.complete.textColor">@color/tab_color_true</item>
        <!--预览界面标题栏背景色-->
        <item name="picture.ac_preview.title.bg">@color/bar_grey</item>
        <!--预览界面底部背景色-->
        <item name="picture.ac_preview.bottom.bg">@color/bar_grey_90</item>
        <!--预览界面状态栏颜色-->
        <item name="picture.status.color">@color/bar_grey_90</item>
        <!--预览界面返回箭头-->
        <item name="picture.preview.leftBack.icon">@drawable/picture_back</item>
        <!--是否改变预览界面状态栏字体颜色为黑色-->
        <item name="picture.preview.statusFontColor">false</item>
        <!--裁剪页面标题背景色-->
        <item name="picture.crop.toolbar.bg">@color/bar_grey</item>
        <!--裁剪页面状态栏颜色-->
        <item name="picture.crop.status.color">@color/bar_grey</item>
        <!--裁剪页面标题文字颜色-->
        <item name="picture.crop.title.color">@color/white</item>
        <!--相册文件夹列表选中图标-->
        <item name="picture.folder_checked_dot">@drawable/orange_oval</item>
    </style>

功能配置

// 进入相册 以下是例子：用不到的api可以不写
 PictureSelector.create(MainActivity.this)
    .openGallery()//全部.PictureMimeType.ofAll()、图片.ofImage()、视频.ofVideo()、音频.ofAudio()
    .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
    .isCamera()// 是否显示拍照按钮 true or false
    .imageFormat(PictureMimeType.PNG)// 拍照保存图片格式后缀,默认jpeg
    .isZoomAnim(true)// 图片列表点击 缩放效果 默认true
    .sizeMultiplier(0.5f)// glide 加载图片大小 0~1之间 如设置 .glideOverride()无效
    .setOutputCameraPath("/CustomPath")// 自定义拍照保存路径,可不填
    .enableCrop()// 是否裁剪 true or false
    .compress()// 是否压缩 true or false
    .glideOverride()// int glide 加载宽高，越小图片列表越流畅，但会影响列表图片浏览的清晰度
    .withAspectRatio()// int 裁剪比例 如16:9 3:2 3:4 1:1 可自定义
    .hideBottomControls()// 是否显示uCrop工具栏，默认不显示 true or false
    .isGif()// 是否显示gif图片 true or false
    .compressSavePath(getPath())//压缩图片保存地址
    .freeStyleCropEnabled()// 裁剪框是否可拖拽 true or false
    .circleDimmedLayer()// 是否圆形裁剪 true or false
    .showCropFrame()// 是否显示裁剪矩形边框 圆形裁剪时建议设为false   true or false
    .showCropGrid()// 是否显示裁剪矩形网格 圆形裁剪时建议设为false    true or false
    .openClickSound()// 是否开启点击声音 true or false
    .selectionMedia()// 是否传入已选图片 List<LocalMedia> list
    .previewEggs()// 预览图片时 是否增强左右滑动图片体验(图片滑动一半即可看到上一张是否选中) true or false
    .cropCompressQuality()// 裁剪压缩质量 默认90 int
    .minimumCompressSize(100)// 小于100kb的图片不压缩 
    .synOrAsy(true)//同步true或异步false 压缩 默认同步
    .cropWH()// 裁剪宽高比，设置如果大于图片本身宽高则无效 int 
    .rotateEnabled() // 裁剪是否可旋转图片 true or false
    .scaleEnabled()// 裁剪是否可放大缩小图片 true or false
    .videoQuality()// 视频录制质量 0 or 1 int
    .videoMaxSecond(15)// 显示多少秒以内的视频or音频也可适用 int 
    .videoMinSecond(10)// 显示多少秒以内的视频or音频也可适用 int 
    .recordVideoSecond()//视频秒数录制 默认60s int
    .isDragFrame(false)// 是否可拖动裁剪框(固定)
    .forResult(PictureConfig.CHOOSE_REQUEST);//结果回调onActivityResult code

集成方式

在根目录 build.gradle 中添加如下：

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

在 app/build.gradle 添加如下：

    //PictureSelector
    implementation 'com.github.LuckSiege.PictureSelector:picture_library:v2.2.3'
    //Gson
    implementation 'com.google.code.gson:gson:2.7'

使用

public class MainActivity extends AppCompatActivity {

    private int maxSelectNum = 9;
    private List<LocalMedia> selectList = new ArrayList<>();
    private GridImageAdapter adapter;
    private RecyclerView mRecyclerView;
    private CommonPopupWindow popupWindow;

    private static final String[] permissionsGroup = new String[]{
            Manifest.permission.CALL_PHONE,
            Manifest.permission.CAMERA,
            Manifest.permission.WRITE_EXTERNAL_STORAGE};
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        checkPermissionRequest();
        mRecyclerView = findViewById(R.id.recycler);

        initWidget();
    }

    private void checkPermissionRequest() {

    }

    private void initWidget() {
        FullyGridLayoutManager manager = new FullyGridLayoutManager(this, 3, GridLayoutManager.VERTICAL, false);
        mRecyclerView.setLayoutManager(manager);
        adapter = new GridImageAdapter(this, onAddPicClickListener);
        adapter.setList(selectList);
        adapter.setSelectMax(maxSelectNum);
        mRecyclerView.setAdapter(adapter);

    }

    private GridImageAdapter.onAddPicClickListener onAddPicClickListener = new GridImageAdapter.onAddPicClickListener() {

        @SuppressLint("CheckResult")
        @Override
        public void onAddPicClick() {
            //获取写的权限
            RxPermissions rxPermission = new RxPermissions(MainActivity.this);
            rxPermission.requestEach(Manifest.permission.WRITE_EXTERNAL_STORAGE)
                    .subscribe(new Consumer<Permission>() {
                        @Override
                        public void accept(Permission permission) {
                            if (permission.granted) {// 用户已经同意该权限
                                //第一种方式，弹出选择和拍照的dialog
                                showPopupWindow();

                                //第二种方式，直接进入相册，但是 是有拍照得按钮的
//                                showAlbum();
                            } else {
                                Toast.makeText(MainActivity.this, "拒绝", Toast.LENGTH_SHORT).show();
                            }
                        }
                    });
        }
    };

    private void showAlbum() {
        //参数很多，根据需要添加
        PictureSelector.create(MainActivity.this)
                .openGallery(PictureMimeType.ofImage())// 全部.PictureMimeType.ofAll()、图片.ofImage()、视频.ofVideo()、音频.ofAudio()
                .maxSelectNum(maxSelectNum)// 最大图片选择数量
                .minSelectNum(1)// 最小选择数量
                .imageSpanCount(4)// 每行显示个数
                .selectionMode(PictureConfig.MULTIPLE)// 多选 or 单选PictureConfig.MULTIPLE : PictureConfig.SINGLE
                .previewImage(true)// 是否可预览图片
                .isCamera(true)// 是否显示拍照按钮
                .isZoomAnim(true)// 图片列表点击 缩放效果 默认true
                //.setOutputCameraPath("/CustomPath")// 自定义拍照保存路径
                .enableCrop(true)// 是否裁剪
                .compress(true)// 是否压缩
                //.sizeMultiplier(0.5f)// glide 加载图片大小 0~1之间 如设置 .glideOverride()无效
                .glideOverride(160, 160)// glide 加载宽高，越小图片列表越流畅，但会影响列表图片浏览的清晰度
                .withAspectRatio(1, 1)// 裁剪比例 如16:9 3:2 3:4 1:1 可自定义
                //.selectionMedia(selectList)// 是否传入已选图片
                //.previewEggs(false)// 预览图片时 是否增强左右滑动图片体验(图片滑动一半即可看到上一张是否选中)
                //.cropCompressQuality(90)// 裁剪压缩质量 默认100
                //.compressMaxKB()//压缩最大值kb compressGrade()为Luban.CUSTOM_GEAR有效
                //.compressWH() // 压缩宽高比 compressGrade()为Luban.CUSTOM_GEAR有效
                //.cropWH()// 裁剪宽高比，设置如果大于图片本身宽高则无效
                .rotateEnabled(false) // 裁剪是否可旋转图片
                //.scaleEnabled()// 裁剪是否可放大缩小图片
                //.recordVideoSecond()//录制视频秒数 默认60s
                .forResult(PictureConfig.CHOOSE_REQUEST);//结果回调onActivityResult code
    }

    private void showPopupWindow() {
        if (popupWindow != null && popupWindow.isShowing()) {
            return;
        }

        View popView = View.inflate(this,R.layout.popup_take_photo,null);

        popupWindow = new CommonPopupWindow.Builder(this)
                .setView(R.layout.popup_take_photo)
                .setAnimationStyle(R.style.AnimUp)
                .setBackGroundLevel(0.5f)
                .setWidthAndHeight(980,400)
                .setViewOnclickListener(new CommonPopupWindow.ViewInterface() {
                    @Override
                    public void getChildView(View view, int layoutResId) {
                        TextView photograph = view.findViewById(R.id.tv_avatar_photograph);
                        TextView selPhoto = view.findViewById(R.id.tv_avatar_photo);
                        TextView cancel = view.findViewById(R.id.tv_avatar_cancel);

                        photograph.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                if (popupWindow != null) {
                                    popupWindow.dismiss();
                                }

                                //拍照
                                PictureSelector.create(MainActivity.this)
                                        .openCamera(PictureMimeType.ofImage())
                                        .forResult(PictureConfig.CHOOSE_REQUEST);
                            }
                        });

                        selPhoto.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                //相册
                                PictureSelector.create(MainActivity.this)
                                        .openGallery(PictureMimeType.ofImage())
                                        .maxSelectNum(maxSelectNum)
                                        .minSelectNum(1)
                                        .imageSpanCount(4)
                                        .selectionMode(PictureConfig.MULTIPLE)
                                        .forResult(PictureConfig.CHOOSE_REQUEST);

                                if (popupWindow != null) {
                                    popupWindow.dismiss();
                                }
                            }
                        });

                        cancel.setOnClickListener(new View.OnClickListener() {
                            @Override
                            public void onClick(View v) {
                                if (popupWindow != null) {
                                    popupWindow.dismiss();
                                }
                            }
                        });

                    }
                })
                .setOutsideTouchable(true)
                .create();

        popupWindow.showAtLocation(popView, Gravity.BOTTOM,0,50);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        List<LocalMedia> images;
        if (resultCode == RESULT_OK) {
            if (requestCode == PictureConfig.CHOOSE_REQUEST) {// 图片选择结果回调

                images = PictureSelector.obtainMultipleResult(data);
                selectList.addAll(images);

                //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();
            }
        }
    }
}

Demo

第三方库之 PictureSelector

效果图

功能

主题配置

功能配置

集成方式

使用

猜你喜欢

热点阅读