开源软件名称：MediaPicker
开源软件地址：https://gitee.com/MingYueChunQiu/MediaPicker
开源软件介绍：
MediaPicker项目中许多时候需要选择图片、音视频，并有大小和时间限制，没有找到合适的库，所以自己提供一个满足需求的基础版本。一.可以选择图片、音频、视频二.可以限制选择数量、音视频大小、时长三.可以进行图片、音视频的预览播放，指定每列显示item个数四.可以自定义过滤条件，只显示符合要求item 最新0.1.8版本：1.升级依赖版本，优化代码 0.1.7版本：1.项目迁移至AndroidX，引入Kotlin 一.实现效果    可以设置显示主题，默认为深色主题
二.引用1.Add it in your root build.gradle at the end of repositories allprojects { repositories { ... maven { url 'https://jitpack.io' } } }2.Add the dependency dependencies { implementation 'com.github.MingYueChunQiu:MediaPicker:0.1.8' }三.使用1.基础使用最简单的使用，全部为默认配置选择图片 final ArrayList<String> list = new ArrayList<>(); list.add(MediaSuffixType.VideoSuffixType.TYPE_MP4); tvTest.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { MediaPicker.init(MainActivity.this)// .setMediaPickerConfig(new MediaPickerConfig.Builder()// .setThemeConfig(new MediaPickerThemeConfig.Builder()// .buildDarkTheme())// .setMediaPickerType(MediaPickerType.TYPE_VIDEO)// .setLimitDuration(10 * 1000)// .setLimitSize(10 * 1024 * 1024L)// .setMaxSelectMediaCount(3)// .setStartPreviewByThird(true)// .setColumnCount(3)// .setLimitSuffixTypeList(list)// .setMediaPickerFilter(new MediaPickerFilter() {// @Override// public boolean filter(MediaInfo info) {// if (info.getSize() > 10 * 1024 * 1024L) {// return true;// }// return false;// }//// @Override// public String getFilteredHint() {// return "测试";// }//// @Override// public boolean hideFiltered() {// return false;// }// })// .setFilterLimitSuffixType(true)// .setFilterLimitMedia(true)// .build()) .pick();获取到的结果在 @Override protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) { super.onActivityResult(requestCode, resultCode, data); if (data != null && requestCode == MP_REQUEST_START_MEDIA_PICKER && resultCode == RESULT_OK) { ArrayList<MediaInfo> list = data.getParcelableArrayListExtra(EXTRA_PICKED_MEDIA_LIST); for (MediaInfo info : list) { Log.d("份", info.getTitle() + " fds " + info.getName() + " " + info.getFilePath() + " " + info.getSize() + " " + info.getDuration() + " " + info.getBucketId() + " " + info.getBucketName()); } } }结果存储在MediaInfo中 public class MediaInfo： private String title;//标题 private String name;//名称（带扩展名） private MediaPickerType type;//多媒体类型 private String suffixType;//后缀名类型（例如：.mp4) private String filePath;//视频路径 private String thumbnail;//缩略图 private long addDate;//添加到Media Provider的时间 private long duration;//时长 private long size;//大小 private String bucketId;//多媒体所属文件夹ID private String bucketName;//多媒体所属文件夹名称 在MediaPicker主要是提供MediaPickerControlable接口实例，默认提供的是MediaPickerControl子类 public class MediaPicker { private static final MediaPicker INSTANCE;//单例 private MediaPickerControlable mControl; private MediaPicker() { } static { INSTANCE = new MediaPicker(); } public static MediaPickerControlable init(@NonNull Activity activity) { return init(activity, new MediaPickerStore(activity), null); } public static MediaPickerControlable init(@NonNull Activity activity, MediaPickerStoreable store, MediaPickerInterceptable intercept) { INSTANCE.mControl = new MediaPickerControl(activity, store, intercept); return INSTANCE.mControl; } public static MediaPickerControlable init(@NonNull Fragment fragment) { return init(fragment, new MediaPickerStore(fragment), null); } public static MediaPickerControlable init(@NonNull Fragment fragment, MediaPickerStoreable store, MediaPickerInterceptable intercept) { INSTANCE.mControl = new MediaPickerControl(fragment, store, intercept); return INSTANCE.mControl; } public static MediaPicker getInstance() { return INSTANCE; } public MediaPickerControlable getMediaPickerControl() { return INSTANCE.mControl; } public static ImageEngine getImageEngine() { return INSTANCE.mControl.getImageEngine(); } public static MediaPickerFilter getMediaPickerFilter() { return INSTANCE.mControl.getMediaPickerStore().getMediaPickerConfig().getMediaPickerFilter(); }}在拿到MediaPickerControlable后，设置相关配置，MediaPickerControlable里持有MediaPickerStoreable接口，默认提供的子类实现是MediaPickerStore，MediaPickerStore主要是用来持有MediaPickerConfig，进行配置设置。 MediaPickerControlable包裹MediaPickerStoreable，使用与实现中间层拦截器，方便实现中间额外操作，所以提供MediaPickerInterceptable接口，默认提供了MediaPickerIntercept空实现子类，可以对所有方法进行拦截监听 2.MediaPickerControlablepublic interface MediaPickerControlable { MediaPickerControlable setMediaPickerConfig(MediaPickerConfig config); MediaPickerControlable setMediaPickerIntercept(MediaPickerInterceptable intercept); ImageEngine getImageEngine(); MediaPickerFilter getMediaPickerFilter(); MediaPickerStoreable getMediaPickerStore(); void pick(); void release();}3.MediaPickerStoreablepublic interface MediaPickerStoreable { MediaPickerStoreable setMediaPickerConfig(MediaPickerConfig config); MediaPickerConfig getMediaPickerConfig(); void pick(); void release();}4.MediaPickerConfigMediaPickerStore实现类里会持有MediaPickerConfig private MediaPickerType mediaPickerType;//多媒体选择类型 private int maxSelectMediaCount;//最多可选择多媒体个数 private long limitSize;//限制大小（单位B） private long limitDuration;//限制时长（毫秒） private List<String> limitSuffixTypeList;//限制只能显示的多媒体后缀类型列表 private MediaPickerFilter mediaPickerFilter;//多媒体过滤器 private boolean filterLimitSuffixType;//是否过滤超出后缀名类型限制的多媒体 private boolean filterLimitMedia;//是否过滤超出限制的多媒体信息 private int columnCount;//一行列数 private int loadAnimation;//Item加载动画 private boolean startPreviewByThird;//以第三方应用方式打开预览多媒体 private MediaPickerThemeConfig themeConfig;//主题配置 private ImageEngine engine;//图片加载引擎 可以通过startPreviewByThird来设置是否通过调用第三方应用来预览，默认是库自带的预览效果，目前设置后只有视频可以打开调用其他第三方应用预览。 在MediaPickerConfig里可以配置界面主题深色和浅色，默认为深色，同时也可以自定义设置 filterLimitSuffixType是和limitSuffixTypeList配合使用，filterLimitMedia和时长、大小与自定义配合使用 public class MediaPickerThemeConfig： private int themeType;//主题类型（浅色或深色，请设置此类时一定要配置涉及到状态栏配置，默认为深色） private @ColorInt int topBackgroundColor;//顶部背景颜色 private @ColorInt int bottomBackgroundColor;//底部背景颜色 private @ColorInt int topTextColor;//顶部文字颜色 private @ColorInt int bottomTextColor;//底部文字颜色 private @DrawableRes int backIconResId;//返回Icon资源ID private @DrawableRes int upTriangleIconResId;//向上三角Icon资源ID private @DrawableRes int downTriangleIconResId;//向下三角Icon资源ID MediaPickerThemeConfig默认提供了buildLightTheme和buildDarkTheme /** * 创建默认浅色主题配置信息 * * @return 返回浅色主题配置信息对象 */ public MediaPickerThemeConfig buildLightTheme() { mConfig.topBackgroundColor = Color.WHITE; mConfig.bottomBackgroundColor = Color.parseColor("#33000000"); mConfig.topTextColor = Color.BLACK; mConfig.bottomTextColor = Color.BLACK; mConfig.backIconResId = R.drawable.mp_back_dark; mConfig.upTriangleIconResId = R.drawable.mp_up_triangle_dark; mConfig.downTriangleIconResId = R.drawable.mp_down_triangle_dark; mConfig.themeType = Constants.ThemeTypeConstants.TYPE_LIGHT; return mConfig; } /** * 创建默认深色主题配置信息 * * @return 返回深色主题配置信息对象 */ public MediaPickerThemeConfig buildDarkTheme() { mConfig.topBackgroundColor = Color.parseColor("#2C2C34"); mConfig.bottomBackgroundColor = Color.parseColor("#2C2C34"); mConfig.topTextColor = Color.WHITE; mConfig.bottomTextColor = Color.WHITE; mConfig.backIconResId = R.drawable.mp_back_light; mConfig.upTriangleIconResId = R.drawable.mp_up_triangle_light; mConfig.downTriangleIconResId = R.drawable.mp_down_triangle_light; mConfig.themeType = Constants.ThemeTypeConstants.TYPE_DARK; return mConfig; }自定义过滤器MediaPickerFilter public interface MediaPickerFilter { /** * 设置条件过滤多媒体Item * * @param info 多媒体信息对象 * @return 满足过滤条件的Item返回true，否则返回false */ boolean filter(MediaInfo info); /** * 获取选择过滤Item时的提示文本（在hideFiltered为false时，使用才有效） * 返回null或""无效，不设置时，默认显示"该项已被过滤，不能选择" * 可以使用MediaPickerFilterAdapter，提供了默认实现，只重新自己需要的方法 * * @return 返回提示字符串 */ String getFilteredHint(); /** * 隐藏被过滤的Item * * @return 返回true表示隐藏，否则返回false */ boolean hideFiltered();}同时可以直接使用MediaPickerFilterAdapter，它实现了MediaPickerFilter，提供默认实现 public class MediaPickerFilterAdapter implements MediaPickerFilter { @Override public boolean filter(MediaInfo info) { return false; } @Override public String getFilteredHint() { return null; } @Override public boolean hideFiltered() { return false; }}库同时还提供了MediaUtils工具类，里面有许多工具方法，可以直接在任何地方直接调用 /** * 启动选择本地图片界面 * * @param activity 启动界面 * @param requestCode 启动请求码 */ public static void startPickImage(@NonNull Activity activity, int requestCode) { } /** * 启动选择本地图片界面 * * @param fragment 启动界面 * @param requestCode 启动请求码 */ public static void startPickImage(@NonNull Fragment fragment, int requestCode) { } /** * 启动选择本地视频界面 * * @param activity 启动界面 * @param requestCode 启动请求码 */ public static void startPickVideo(@NonNull Activity activity, int requestCode) { } /** * 启动选择本地视频界面 * * @param fragment 启动界面 * @param requestCode 启动请求码 */ public static void startPickVideo(@NonNull Fragment fragment, int requestCode) { }/** * 查询系统数据库地址中视频信息 * * @param resolver Android组件 * @param uri 视频本地地址 * @return 如果成功获取数据，则返回MediaInfo，否则返回null */ @Nullable public static MediaInfo queryVideoInfo(@NonNull ContentResolver resolver, @NonNull Uri uri) { } /** * 根据缩略图路径获取缩略图 * * @param path 缩略图路径 * @return 返回生成的缩略图 */ public static Bitmap getThumbnail(String path) { } /** * 设置视频播放声音 * * @param volume 声音音量（0--1） * @param o 播放的对象 */ public static void setVolume(float volume, Object o) { } /** * 获取图片资源 * * @param context 上下文 * @param callback 浏览资源回调 */ public static void getImages(final Context context, BrowseMediaInfoCallback callback) { }/** * 获取音频资源 * * @param context 上下文 * @param callback 浏览资源回调 */ public static void getAudios(final Context context, BrowseMediaInfoCallback callback) { }/** * 获取视频资源 * * @param context 上下文 * @param callback 浏览资源回调 */ public static void getVideos(final Context context, BrowseMediaInfoCallback callback) { }@NonNull private static Intent getPickImageIntent() { } /** * 获取选择视频的启动意图 * * @return 返回启动意图 */ @NonNull private static Intent getPickVideoIntent() { } /** * 浏览多媒体信息回调 */ public interface BrowseMediaInfoCallback { /** * 当准备浏览多媒体信息时调用 */ void onPrepareBrowseMediaInfo(); /** * 当开始浏览多媒体信息时调用 * * @param count 多媒体总数 */ void onStartBrowseMediaInfo(int count); /** * 浏览多媒体资源信息时调用 * * @param index 浏览的索引位置 * @param info 多媒体信息数据 */ void onBrowseMediaInfo(int index, @NonNull MediaInfo info); /** * 当结束浏览多媒体信息时回调 */ void onEndBrowseMediaInfo(); }5.图片引擎用户可以设置ImageEngine MediaPicker.init(MainActivity.this) .setMediaPickerConfig(new MediaPickerConfig.Builder()  |
客服电话
APP下载
官方微信
请发表评论