.setFirstImageUrl(null)//设置上一次选中的图片地址
.setVideoSinglePick(true)//设置视频单选
.setCropPicSaveFilePath(“剪裁图片保存路径”)
.setMaxVideoDuration(2000L)//设置可选取的最大视频时长
.setMinVideoDuration(60000L)//设置视频可选取的最小时长
.pick(this, new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//图片剪裁回调，主线程
//注意：剪裁回调里的 ImageItem 中 getCropUrl()才是剪裁过后的图片地址
}
});
预览
支持普通预览和编辑预览，示例如下：
//配置需要预览的所有图片列表
ArrayList allPreviewImageList = new ArrayList<>();
//默认选中的图片索引
int defaultPosition = 0;
//开启编辑预览
ImagePicker.preview(this, new WXImgPickerPresenter(), allPreviewImageList, defaultPosition, new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//图片编辑回调，主线程
}
});
拍照
支持直接打开摄像头拍照，示例如下：
ImagePicker.takePhoto(this, “拍照保存路径”, new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//拍照回调，主线程
}
});
拍摄视频
支持直接打开摄像头拍视频，示例如下：
ImagePicker.takeVideo(this, “视频保存路径”, new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//拍照回调，主线程
}
});
调用选择器并剪裁
支持选择图片完调用剪裁，支持自定义比例剪裁，支持圆形剪裁，示例如下：
ImagePicker.withMulti(new WXImgPickerPresenter())
.mimeType(MimeType.ofImage())
.filterMimeType(MimeType.GIF)
//设置剪裁比例
.setCropRatio(1,1)
.cropSaveFilePath(“剪裁图片保存路径”)
//设置剪裁框间距，单位 px
.cropRectMinMargin(50)
//是否圆形剪裁，圆形剪裁时，setCropRatio 无效
.cropAsCircle()
//设置剪裁模式，留白或充满 CropConfig.STYLE_GAP 或 CropConfig.STYLE_FILL
.cropStyle(CropConfig.STYLE_FILL)
//设置留白模式下生成的图片背景色，支持透明背景
.cropGapBackgroundColor(Color.TRANSPARENT)
.crop(this, new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//图片剪裁回调，主线程
}
});
拍照并剪裁
支持直接打开摄像头拍照并剪裁，支持自定义比例剪裁和圆形剪裁，示例如下：
//配置剪裁属性
CropConfig cropConfig = new CropConfig();
//设置剪裁比例
cropConfig.setCropRatio(1, 1);
//设置剪裁框间距，单位 px
cropConfig.setCropRectMargin(100);
cropConfig.setCropSaveFilePath(“剪裁生成的图片路径”);
//是否圆形剪裁，圆形剪裁时，setCropRatio 无效
cropConfig.setCircle(false);
//设置剪裁模式，留白或充满 CropConfig.STYLE_GAP 或 CropConfig.STYLE_FILL
cropConfig.setCropStyle(CropConfig.STYLE_GAP);
//设置留白模式下生成的图片背景色，支持透明背景
cropConfig.setCropGapBackgroundColor(Color.TRANSPARENT );
//调用拍照
ImagePicker.takePhotoAndCrop(this, new WXImgPickerPresenter(), cropConfig,
new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//剪裁回调，主线程
}
});
直接剪裁
支持直接跳转剪裁页面，示例如下：
CropConfig cropConfig = new CropConfig();
//设置剪裁比例
cropConfig.setCropRatio(1, 1);
//设置剪裁框间距，单位 px
cropConfig.setCropRectMargin(100);
cropConfig.setCropSaveFilePath(“剪裁生成的图片路径”);
//是否圆形剪裁，圆形剪裁时，setCropRatio 无效
cropConfig.setCircle(false);
//设置剪裁模式，留白或充满 CropConfig.STYLE_GAP 或 CropConfig.STYLE_FILL
cropConfig.setCropStyle(CropConfig.STYLE_GAP);
//设置留白模式下生成的图片背景色，支持透明背景
cropConfig.setCropGapBackgroundColor(Color.TRANSPARENT );
//调用剪裁
String needCropImageUrl=“需要剪裁的图片路径”;
ImagePicker.crop(this, new WXImgPickerPresenter(), cropConfig, needCropImageUrl，
new OnImagePickCompleteListener() {
@Override
public void onImagePickComplete(ArrayList items) {
//剪裁回调，主线程
}
});
提供媒体数据——支持回调相册数据、所有媒体数据、指定相册内媒体数据
获取媒体相册数据
//指定要回调的相册类型，可以指定 13 种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
ImagePicker.provideMediaSets(this, mimeTypes, new MediaSetsDataSource.MediaSetProvider() {
@Override
public void providerMediaSets(ArrayList imageSets) {
//相册列表回调，主线程
}
});
获取全部媒体文件
//指定要回调的相册类型，可以指定 13 种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
ImagePicker.provideAllMediaItems(this, mimeTypes, new MediaItemsDataSource.MediaItemProvider() {
@Override
public void providerMediaItems(ArrayList imageItems, ImageSet allVideoSet) {
//全部媒体数据回调，主线程
//只有当 mimeTypes 既包含图片或者视频格式文件时，allVideoSet 才有值
}
});
获取指定相册内全部媒体文件
//指定要回调的相册类型，可以指定 13 种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
//指定相册，id 不能为空
ImageSet imageSet = new ImageSet();
ImagePicker.provideMediaItemsFromSet(this, imageSet, mimeTypes, new MediaItemsDataSource.MediaItemProvider() {
@Override
public void providerMediaItems(ArrayList imageItems, ImageSet allVideoSet) {
//全部媒体数据回调，主线程
//只有当 mimeTypes 既包含图片或者视频格式文件时，allVideoSet 才有值
}
});
预加载获取指定相册内全部媒体文件
//指定要回调的相册类型，可以指定 13 种图片视频文件格式混合
Set mimeTypes = MimeType.ofAll();
//指定相册，id 不能为空
ImageSet imageSet = new Im
ageSet();
//预加载个数
int preloadSize = 40;
ImagePicker.provideMediaItemsFromSetWithPreload(this, imageSet, mimeTypes, preloadSize,
new MediaItemsDataSource.MediaItemPreloadProvider() {
@Override
public void providerMediaItems(ArrayList imageItems) {
//预加载回调，预先加载指定数目的媒体文件回调
}
},
new MediaItemsDataSource.MediaItemProvider() {
@Override
public void providerMediaItems(ArrayList imageItems, ImageSet allVideoSet) {
//所有媒体文件回调
}
});
presenter 指定、自定义 Item 样式、自定义皮肤 UI、自定义提示常量、设置选择器调用失败回调、自定义回调类型
详细使用方法请查看详细 API 文档
版本记录
查看详细版本记录
2.4.6 版本 [.11.02]
【BUG 修复】修复了红米拍照闪退问题
【BUG 修复】取消了选择器没有文件时直接退出选择器的策略。改为提示语句“暂未发现媒体文件”.
【适配】已适配 AndroidQ，解决 targetSdkVersion 设置 29 时数据库报错的 bug
【新增】新增直接拍摄视频
【新增】presenter 新增 overMaxCountTip、interceptPickerCancel、interceptVideoClick、getPickConstants 四个方法
【新增】新增 PickConstants 用于修改选择器所有文案，在 presenter 中指定
【新增】支持直接回调媒体数据，其中包含回调相册列表、全部媒体文件、指定相册里媒体文件，支持指定数量预加载。
【新增】新增退出选择器时拦截回调，新增点击视频 item 的拦截回调，在 presenter 中指定
【新增】新增视频最小选择时长
【优化】重构了预览页面，将选择器预览和通用预览分离，降低耦合度
【优化】统一整理了资源文件命名，以及删除不必要的资源
【调整】clearAllCache 方法已废弃
【调整】原有的选择器拍照会直接回调出照片，现在改为生成在选择器的第一个
【调整】当选择器只加载视频时，拍照 item 支持拍摄视频，其他情况均为拍照
【优化】选择器调用屏蔽多次点击，调用多次
【优化】所有不可选择的 item(置灰)选中均会有具体的提示
下个版本排期
ickConstants 四个方法
【新增】新增 PickConstants 用于修改选择器所有文案，在 presenter 中指定
【新增】支持直接回调媒体数据，其中包含回调相册列表、全部媒体文件、指定相册里媒体文件，支持指定数量预加载。
【新增】新增退出选择器时拦截回调，新增点击视频 item 的拦截回调，在 presenter 中指定
【新增】新增视频最小选择时长
【优化】重构了预览页面，将选择器预览和通用预览分离，降低耦合度
【优化】统一整理了资源文件命名，以及删除不必要的资源
【调整】clearAllCache 方法已废弃
【调整】原有的选择器拍照会直接回调出照片，现在改为生成在选择器的第一个
【调整】当选择器只加载视频时，拍照 item 支持拍摄视频，其他情况均为拍照
【优化】选择器调用屏蔽多次点击，调用多次
【优化】所有不可选择的 item(置灰)选中均会有具体的提示
