Android-图片选择器ImageSelector的简单使用、
2022-02-13 本文已影响0人
晴天ccc
文章参考/搬运：
https://github.com/donkingliang/ImageSelector
https://blog.csdn.net/qq_33209777/article/details/121751644
1、引入依赖的第三方库
在build.gradle在添加以下代码
implementation 'com.github.donkingliang:ImageSelector:2.2.1'
2、配置AndroidManifest.xml
<!--允许程序写入文件到外部存储-->
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
tools:ignore="ScopedStorage" />
<!--允许程序读取外部存储的文件-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!--允许访问摄像头进行拍照-->
<uses-permission android:name="android.permission.CAMERA" />
<!-- 第三方库ImageSelector图片选择Activity-->
<activity
android:name="com.donkingliang.imageselector.ImageSelectorActivity"
android:configChanges="orientation|keyboardHidden|screenSize"
android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
<!-- 第三方库ImageSelector图片预览Activity-->
<activity
android:name="com.donkingliang.imageselector.PreviewActivity"
android:configChanges="orientation|keyboardHidden|screenSize"
android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
<!-- 第三方库ImageSelector图片剪切Activity-->
<activity
android:name="com.donkingliang.imageselector.ClipImageActivity"
android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
3、如何使用
//单选
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(true) //设置是否单选
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//限数量的多选(比如最多9张)
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(false) //设置是否单选
.setMaxSelectCount(9) // 图片的最大选择数量，小于等于0时，不限数量。
.setSelected(selected) // 把已选的图片传入默认选中。
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//不限数量的多选
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(false) //设置是否单选
.setMaxSelectCount(0) // 图片的最大选择数量，小于等于0时，不限数量。
.setSelected(selected) // 把已选的图片传入默认选中。
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//单选并剪裁
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setCrop(true) // 设置是否使用图片剪切功能。
.setCropRatio(1.0f) // 图片剪切的宽高比,默认1.0f。宽固定为手机屏幕的宽。
.setSingle(true) //设置是否单选
.canPreview(true) //是否可以预览图片，默认为true
.start(this, REQUEST_CODE); // 打开相册
//仅拍照
ImageSelector.builder()
.onlyTakePhoto(true) // 仅拍照，不打开相册
.start(this, REQUEST_CODE);
//拍照并剪裁
ImageSelector.builder()
.setCrop(true) // 设置是否使用图片剪切功能。
.setCropRatio(1.0f) // 图片剪切的宽高比,默认1.0f。宽固定为手机屏幕的宽。
.onlyTakePhoto(true) // 仅拍照，不打开相册
.start(this, REQUEST_CODE);
REQUEST_CODE根据自己的业务逻辑自己设置对应的CODE。
4、数据回调
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE && data != null) {
//获取选择器返回的数据
ArrayList<String> images = data.getStringArrayListExtra(
ImageSelector.SELECT_RESULT);
/**
* 是否是来自于相机拍照的图片，
* 只有本次调用相机拍出来的照片，返回时才为true。
* 当为true时，图片返回的结果有且只有一张图片。
*/
boolean isCameraImage = data.getBooleanExtra(ImageSelector.IS_CAMERA_IMAGE, false);
}
}
ImageSelector.SELECT_RESULT是接收数据的key。ArrayList里面的数据就是选中的图片的文件路径。- 数据是以
ArrayList的字符串数组返回的，就算是单选，返回的也是ArrayList数组，只不过这时候ArrayList只有一条数据而已。
5、适配Android 10
兼容android 10的手机请使用1.7.0版本。
由于·Android 10·不允许应用直接访问外部文件，所以在android 10及以上的手机，ImageSelect返回的图片链接可能无法直接加载。
因为ImageSelector返回的是图片在手机里的地址。但是可以通过uri进行加载，ImageSelector内部提供了一些方法可以供外部使用，用于适配Android 10。
//是否是Android 10及以上
VersionUtils.isAndroidQ();
// Android 10可以通过图片uri加载手机本地图片。
//图片链接转uri
Uri uri = UriUtils.getImageContentUri(Context context, String path);
//通过uri加载图片
Glide.with(mContext).load(uri).into(ivImage);
ivImage.setImageURI(uri);
// 或者
Bitmap bitmap = ImageUtil.getBitmapFromUri(Context context, Uri uri);
注意： 剪切返回的图片的图片链接是放在应用的私有目录的，所以剪切返回的图片可以直接用path加载，不需要转成uri再加载。ImageSelector提供了判断图片链接是否是剪切的图片的方法。
// 是否是剪切返回的图片
ImageUtil.isCutImage(mContext, path);
6、图片预加载和缓存
由于从手机中加载图库是个耗时操作，图片太多时，打开图库可能等待时间过长，用户体验不好。所以在2.1.0版本和1.9.0版本开始，提供了预加载手机图片并缓存的功能。你可以在用户打开图片选择器前，预先加载手机图片，这样在用户打开图片选择器时，会直接从缓存中读取图片列表，大大提升选择器的加载速度。
选择器默认不开启预加载并缓存功能，如果需要预加载，请调用下面的方法：
ImageSelector.preload(context);
调用这个方法的时机没有特殊的要求，只要是在打开选择器前调用就可以了。
注意： 由于加载手机图片需要申请WRITE_EXTERNAL_STORAGE权限，所以在调用该方法前，请确保权限已申请。
在选择器使用完毕，不再需要时，可以调用下面方法清空缓存：
ImageSelector.clearCache(context);
清空缓存的操作不是必须的，如果不清空，缓存会一直保留，直到app被回收。因为缓存的是图片的路径，所以不会占用太多的内存
7、显示图片问题
不过我们可以通过图片uri来加载图片，这种方式在Android 10也是可以的。 先将图片路径转换成uri 。
public static Uri getImageContentUri(Context context, String path) {
Cursor cursor = context.getContentResolver().query(MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
new String[] { MediaStore.Images.Media._ID }, MediaStore.Images.Media.DATA + "=? ",
new String[] { path }, null);
if (cursor != null && cursor.moveToFirst()) {
int id = cursor.getInt(cursor.getColumnIndex(MediaStore.MediaColumns._ID));
Uri baseUri = Uri.parse("content://media/external/images/media");
return Uri.withAppendedPath(baseUri, "" + id);
} else {
// 如果图片不在手机的共享图片数据库，就先把它插入。
if (new File(path).exists()) {
ContentValues values = new ContentValues();
values.put(MediaStore.Images.Media.DATA, path);
return context.getContentResolver().insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
} else {
return null;
}
}
}
然后就可以直接通过图片uri加载图片了。
Bitmap bitmap = getBitmapFromUri(context, uri);
// 通过uri加载图片
public static Bitmap getBitmapFromUri(Context context, Uri uri) {
try {
ParcelFileDescriptor parcelFileDescriptor =
context.getContentResolver().openFileDescriptor(uri, "r");
FileDescriptor fileDescriptor = parcelFileDescriptor.getFileDescriptor();
Bitmap image = BitmapFactory.decodeFileDescriptor(fileDescriptor);
parcelFileDescriptor.close();
return image;
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
// Glide使用uri加载图片
Glide.with(mContext).load(uri).into(imageView);
//setImageURI
imageView.setImageURI(uri);
