今天给大家介绍一个仿微信的图片选择器:ImageSelector。ImageSelector支持图片的单选、限数量的多选和不限数量的多选。支持图片预览和图片文件夹的切换。在上一篇文章 《Android 实现一个仿微信的图片选择器》 中我介绍了ImageSelector的实现思路和分析了它的核心代码,有兴趣的同学可以看一下。完整的代码放在了GitHub,欢迎大家下载和使用。本篇文章为大家介绍ImageSelector的具体使用方式。
先上效果图:
**1、引入依赖 **
在Project的build.gradle在添加以下代码
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
maven { url 'https://maven.google.com' }
}
}
在Module的build.gradle在添加以下代码
compile 'com.github.donkingliang:ImageSelector:1.6.0'
2、配置AndroidManifest.xml
在res/xml文件夹下创建file_paths.xml文件(名字可以自己定义)
3、调起图片选择器
ImageSelector支持图片的单选、限数量的多选和不限数量的多选。还可以设置是否使用相机、是否剪切图片等配置。ImageSelector提供了统一的调起相册的方法。
//单选
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(true) //设置是否单选
.start(this, REQUEST_CODE); // 打开相册
//限数量的多选(比喻最多9张)
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(false) //设置是否单选
.setMaxSelectCount(9) // 图片的最大选择数量,小于等于0时,不限数量。
.setSelected(selected) // 把已选的图片传入默认选中。
.start(this, REQUEST_CODE); // 打开相册
//不限数量的多选
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setSingle(false) //设置是否单选
.setMaxSelectCount(0) // 图片的最大选择数量,小于等于0时,不限数量。
.setSelected(selected) // 把已选的图片传入默认选中。
.start(this, REQUEST_CODE); // 打开相册
//单选并剪裁
ImageSelector.builder()
.useCamera(true) // 设置是否使用拍照
.setCrop(true) // 设置是否使用图片剪切功能。
.setSingle(true) //设置是否单选
.start(this, REQUEST_CODE); // 打开相册
REQUEST_CODE就是调用者自己定义的启动Activity时的requestCode,这个相信大家都能明白。selected可以在再次打开选择器时,把原来已经选择过的图片传入,使这些图片默认为选中状态。
4、接收选择器返回的数据
在Activity的onActivityResult方法中接收选择器返回的数据。
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE && data != null) {
//获取选择器返回的数据
ArrayList images = data.getStringArrayListExtra(
ImageSelectorUtils.SELECT_RESULT);
}
}
ImageSelectorUtils.SELECT_RESULT是接收数据的key。数据是以ArrayList的字符串数组返回的,就算是单选,返回的也是ArrayList数组,只不过这时候ArrayList只有一条数据而已。ArrayList里面的数据就是选中的图片的文件路径。
ImageSelector的使用就介绍到这里了。
最后给出ImageSelector的项目地址:https://github.com/donkingliang/ImageSelector