小红书图片剪裁框架+微信图片选择器+超高清大图预览+图片自定义比例剪裁，支持 UI 自定义、支持跨进程回调(2)_mediaitemsdatasource setpreloadprovider-CSDN博客

本文链接：https://blog.csdn.net/2401_84121499/article/details/137436491

本文介绍了微信风格的AndroidImagePicker库，包括设置视频时长限制、预览、拍照、拍摄视频、图片剪裁、媒体数据获取、自定义回调等功能，并提及了库的版本更新和未来计划。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

.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 ImageSet();

//预加载个数

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 版本 [2019.11.02]

【BUG 修复】修复了红米拍照闪退问题
【BUG 修复】取消了选择器没有文件时直接退出选择器的策略。改为提示语句“暂未发现媒体文件”.
【适配】已适配 AndroidQ，解决 targetSdkVersion 设置 29 时数据库报错的 bug
【新增】新增直接拍摄视频
【新增】presenter 新增 overMaxCountTip、interceptPickerCancel、interceptVideoClick、getPickConstants 四个方法
【新增】新增 PickConstants 用于修改选择器所有文案，在 presenter 中指定
【新增】支持直接回调媒体数据，其中包含回调相册列表、全部媒体文件、指定相册里媒体文件，支持指定数量预加载。
【新增】新增退出选择器时拦截回调，新增点击视频 item 的拦截回调，在 presenter 中指定
【新增】新增视频最小选择时长
【优化】重构了预览页面，将选择器预览和通用预览分离，降低耦合度
【优化】统一整理了资源文件命名，以及删除不必要的资源
【调整】clearAllCache 方法已废弃
【调整】原有的选择器拍照会直接回调出照片，现在改为生成在选择器的第一个
【调整】当选择器只加载视频时，拍照 item 支持拍摄视频，其他情况均为拍照
【优化】选择器调用屏蔽多次点击，调用多次
【优化】所有不可选择的 item(置灰)选中均会有具体的提示

下个版本排期

时间：2019 年 11 月中旬

适配 AndroidQ（2.4.6 已支持）
微信选择器加入原图选项
支持对外暴露数据源，以便于实现类似 QQ 发消息时的选择图片（2.4.6 已支持）
实现最新版微信样式
剪裁支持输出指定大小图片
等你来提

计划 TODO：

视频预览框架切换（吐槽：官方 videoView 太难用了/(ㄒoㄒ)/）
图片剪裁支持旋转
支持 JPEG、PNG、GIF、BMP、WEBP、MPEG、MP4、QUICKTIME、THREEGPP、THREEGPP2、MKV、WEBM、TS、AVI 等图片视频文件格式混合加载或指定加载（2.4.4 已支持）

永不 TODO：