# PictureSelector **Repository Path**: imoji/PictureSelector ## Basic Information - **Project Name**: PictureSelector - **Description**: No description available - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: version_component - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2022-01-18 - **Last Updated**: 2022-01-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # PictureSelector 3.0 一款针对Android平台下的图片选择器，支持从相册获取图片、视频、音频&拍照，支持裁剪(单图or多图裁剪)、压缩、主题自定义配置等功能，支持动态获取权限&适配Android 5.0+系统的开源图片选择框架。
[English🇺🇸](README.md) [效果体验](https://github.com/LuckSiege/PictureSelector/raw/version_component/app/demo/demo_2022-01-16_050949_v3.0.2.apk)
[![PRs Welcome](https://img.shields.io/badge/PRs-Welcome-brightgreen.svg)](https://github.com/LuckSiege) [![CSDN](https://img.shields.io/twitter/url/http/blog.csdn.net/luck_mw.svg?style=social)](http://blog.csdn.net/luck_mw) [![I](https://img.shields.io/github/issues/LuckSiege/PictureSelector.svg)](https://github.com/LuckSiege/PictureSelector/issues) [![Star](https://img.shields.io/github/stars/LuckSiege/PictureSelector.svg)](https://github.com/LuckSiege/PictureSelector) ## 目录 -[如何引用](#如何引用)
-[进阶使用](#进阶使用)
-[返回结果说明](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-LocalMedia%E8%AF%B4%E6%98%8E)
-[演示效果](#演示效果)
-[混淆配制](#混淆配制)
-[常见错误](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%B8%B8%E8%A7%81%E9%94%99%E8%AF%AF)
-[如何提Issues](https://github.com/LuckSiege/PictureSelector/wiki/%E5%A6%82%E4%BD%95%E6%8F%90Issues%3F)
-[兼容性测试](#兼容性测试)
-[联系方式](#联系方式)
-[License](#License)
## 如何引用 使用Gradle ```sh repositories { google() mavenCentral() } dependencies { // PictureSelector 基础 (必须) implementation 'io.github.lucksiege:pictureselector:v3.0.2' // 图片压缩 (按需引入) implementation 'io.github.lucksiege:compress:v3.0.2' // 图片裁剪 (按需引入) implementation 'io.github.lucksiege:ucrop:v3.0.2' // 自定义相机 (按需引入) implementation 'io.github.lucksiege:camerax:v3.0.2' } ``` 或者Maven: ```sh io.github.lucksiege pictureselector v3.0.2 io.github.lucksiege compress v3.0.2 io.github.lucksiege ucrop v3.0.2 io.github.lucksiege camerax v3.0.2 ``` ## 进阶使用 想要了解更多功能，请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%8A%9F%E8%83%BDapi%E8%AF%B4%E6%98%8E) 简单用例如下所示: 1、获取图片 [GlideEngine](https://github.com/LuckSiege/PictureSelector/blob/version_component/app/src/main/java/com/luck/pictureselector/GlideEngine.java) ```sh PictureSelector.create(this) .openGallery(SelectMimeType.ofImage()) .setImageEngine(GlideEngine.createGlideEngine()) .forResult(new OnResultCallbackListener() { @Override public void onResult(List result) { } @Override public void onCancel() { } }); ``` 2、单独拍照 ```sh PictureSelector.create(this) .openCamera(SelectMimeType.ofImage()) .forResult(new OnResultCallbackListener() { @Override public void onResult(List result) { } @Override public void onCancel() { } }); ``` 3、您还可以按如下示例使用： (1)、注入到任意视图层 ```sh PictureSelector.create(this) .openGallery(SelectMimeType.ofAll()) .setImageEngine(GlideEngine.createGlideEngine()) .buildLaunch(R.id.fragment_container, new OnResultCallbackListener() { @Override public void onResult(ArrayList result) { } @Override public void onCancel() { } }); ``` (2)、自行注入到任意视图层 ```sh PictureSelectorFragment selectorFragment = PictureSelector.create(this) .openGallery(SelectMimeType.ofAll()) .setImageEngine(GlideEngine.createGlideEngine()) .build(); getSupportFragmentManager().beginTransaction() .add(R.id.fragment_container, selectorFragment, selectorFragment.getFragmentTag()) .addToBackStack(selectorFragment.getFragmentTag()) .commitAllowingStateLoss(); ``` 4、预览图片或视频 ```sh PictureSelector.create(this) .openPreview() .setImageEngine(GlideEngine.createGlideEngine()) .setExternalPreviewEventListener(new OnExternalPreviewEventListener() { @Override public void onPreviewDelete(int position) { } @Override public boolean onLongPressDownload(LocalMedia media) { return false; } }).startActivityPreview(position, true, "data"); ``` 5、预览音频 ```sh AudioPlayDialog.showPlayAudioDialog(getContext(), availablePath); ``` 设置图片选择器主题，更多请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E4%B8%BB%E9%A2%98api%E8%AF%B4%E6%98%8E) ```sh .setSelectorUIStyle(); ``` 或者您可以重载布局，更多请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E9%87%8D%E8%BD%BD%E5%B8%83%E5%B1%80%EF%BC%9F) ```sh .setInjectLayoutResourceListener(new OnInjectLayoutResourceListener() { @Override public int getLayoutResourceId(Context context, int resourceSource) { return 0; } ``` 高级用例如下所示： 1、使用自定义相机功能，详情请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E8%87%AA%E5%AE%9A%E4%B9%89%E7%9B%B8%E6%9C%BA%EF%BC%9F) ```sh .setCameraInterceptListener(new OnCameraInterceptListener() { @Override public void openCamera(Fragment fragment, int cameraMode, int requestCode){ } }); ``` 2、使用图片压缩功能，详情请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E5%8E%8B%E7%BC%A9%EF%BC%9F) ```sh .setCompressEngine(new CompressEngine() { @Override public void onStartCompress(Context context, ArrayList list, OnCallbackListener> call){ } }); ``` 3、使用图片裁剪功能，详情请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E8%A3%81%E5%89%AA%EF%BC%9F) ```sh .setCropEngine(new CropEngine() { @Override public void onStartCrop(Fragment fragment, LocalMedia currentLocalMedia, ArrayList dataSource, int requestCode) { } }); ``` 4、使用图片编辑功能，详情请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E7%BC%96%E8%BE%91%E5%9B%BE%E7%89%87%EF%BC%9F) ```sh .setEditMediaInterceptListener(new OnMediaEditInterceptListener() { @Override public void onStartMediaEdit(Fragment fragment, LocalMedia currentLocalMedia, int requestCode) { } }); ``` 5、加载自定义数据源，详情请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E5%8A%A0%E8%BD%BD%E8%87%AA%E5%AE%9A%E4%B9%89%E6%95%B0%E6%8D%AE%E6%BA%90%EF%BC%9F) ```sh .setExtendLoaderEngine(new ExtendLoaderEngine() { @Override public void loadAllAlbumData(Context context, OnQueryAllAlbumListener query) { } @Override public void loadOnlyInAppDirAllMediaData(Context context, OnQueryAlbumListener query) { } @Override public void loadFirstPageMediaData(Context context, long bucketId, int page, int pageSize, OnQueryDataResultListener query) { } @Override public void loadMoreMediaData(Context context, long bucketId, int page, int limit, int pageSize, OnQueryDataResultListener query) { } }); ``` 6、自定义权限申请，详情请参阅[文档](https://github.com/LuckSiege/PictureSelector/wiki/PictureSelector-3.0-%E5%A6%82%E4%BD%95%E8%87%AA%E5%AE%9A%E4%B9%89%E6%9D%83%E9%99%90%E7%94%B3%E8%AF%B7-%EF%BC%9F) ```sh .setPermissionsInterceptListener(new OnPermissionsInterceptListener() { @Override public void requestPermission(Fragment fragment, String[] permissionArray, OnCallbackListener call) { } @Override public boolean hasPermissions(Fragment fragment) { return false; } }); ``` ## 混淆配置 ```sh -keep class com.luck.picture.lib.** { *; } -keep class com.luck.lib.camerax.** { *; } // 如果引入了Ucrop库请添加混淆 -dontwarn com.yalantis.ucrop** -keep class com.yalantis.ucrop** { *; } -keep interface com.yalantis.ucrop** { *; } ``` ## License ```sh Copyright 2016 Luck Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ``` ## 联系方式 Android开发交流 [662320389]()
Android开发交流 [619458861]()
Android开发交流 [679824206]()
Android开发交流 [854136996]()
QQ [893855882]()
## 兼容性测试 ******腾讯优测-深度测试-通过率达到100%****** ![image](https://github.com/LuckSiege/PictureSelector/blob/version_component/image/test.png) ## 演示效果 | 单一模式 | 混选模式 | |:-----------:|:-----------:| |![](image/home.jpg)|![](image/home_mixed.jpg)| | 默认风格 | 预览 | 多图裁剪 | |:-----------:|:--------:|:---------:| |![](image/picture_default_style_1.jpg) | | ![](image/picture_default_style_new_3.jpg)| | 数字风格 | 预览 | 多图裁剪 | |:-----------:|:--------:|:---------:| |![](image/picture_num_style_new_1.jpg) | ![](image/picture_num_style_new_2.jpg) | ![](image/picture_num_style_new_3.jpg)| | 白色风格 | 预览 | 单图裁剪 | |:-----------:|:--------:|:---------:| |![](image/picture_sina_style_1.jpg) | ![](image/picture_sina_style_new_2.jpg) | ![](image/picture_sina_style_new_3.jpg)| | 全新风格 | 预览 | 多图裁剪 | |:-----------:|:--------:|:---------:| |![](image/picture_wechat_style_1.jpg) | ![](image/picture_wechat_style_2.jpg) | ![](image/picture_wechat_style_new_3.jpg)| | 相册目录 | 单选模式 | 头像裁剪| |:-----------:|:--------:|:--------:| |![](image/picture_wechat_album_style.jpg) |![](image/picture_wechat_single_style_3.jpg) | ![](image/picture_circular_crop_new_style.jpg)| | 白色风格 | 视频 | 音频 | |:-----------:|:-----------:|:--------:| |![](image/picture_white_style.jpeg) |![](image/picture_video.jpg) | ![](image/picture_audio.jpg)|