说明
ImageSelect是android 经量级选择图片框架,支持拍照,获取相册图片,本地视频,可以多选,单选,非常适合做选择图片上传场景。
声明
此框架功能点有:
- 新增对图片列表展示的个数;
- 将图片的加载框架默认不处理,需要自己去实现IEngine接口来实现图片加载,详情查看demo里面的GlideEngine.kt类;
- 新增多图选择时,点击图片进入产看图片模式,方便预览;
- 集成5.0以上权限处理问题;
- 支持Androidx;
- 支持视频加载展示,优化了api接口调用。
效果展示
使用
Get it
- step1: add to your project build.gradle
allprojects {
repositories {
maven { url "https://jitpack.io" }
jcenter()
mavenCentral()
google()
}
}
- step2: Add the dependency
implementation 'com.github.JackLiaoJH:ImageSelect:1.2.0'
初始化
// 实现IEngine接口,如glide加载
class GlideEngine : IEngine {
override fun loadImage(imageView: ImageView, uiConfig: MediaUiConfigVo) {
Glide.with(imageView)
.load(uiConfig.path)
.placeholder(uiConfig.placeholderResId)
.error(uiConfig.errorResId)
.override(uiConfig.width, uiConfig.height)
.centerCrop()
.into(imageView)
}
}
//在Application里面初始化框架图片加载逻辑:
override fun onCreate() {
super.onCreate()
ImageSelector.setImageEngine(GlideEngine())
}
简单使用
//打开照片列表
ImageSelector.startImageAction(
this, IMAGE_CODE, MediaSelectConfig.Builder()
.setShowCamera(true) //是否展示打开摄像头拍照入口,只针对照片,视频列表无效
.setOpenCameraOnly(isOpneCameraOnly) //是否只是打开摄像头拍照而已
.setOriginData(mSelectPath) //已选择图片地址
.setMaxCount(9)//选择最大集合,默认9
.setImageSpanCount(4) //自定义列表展示个数,默认3
.setPlaceholderResId(R.mipmap.ic_launcher) //预览图
.build()
)
//打开视频列表
ImageSelector.startVideoAction(
this, IMAGE_CODE, MediaSelectConfig.Builder()
.setOriginData(mSelectPath) //已选择图片地址
.setImageSpanCount(4) //自定义列表展示个数,默认3
.build()
)
获取结果,重写onActivityResult()方法
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == REQUEST_IMAGE) {
if (resultCode == Activity.RESULT_OK) {
mSelectPath = ImageSelector.getSelectResults(data)
Log.e("ImageSelect", "结果: $mSelectPath")
}
}
}