产品特色-EasyPhotos
- 兼容android 11
- 兼容android 10
- 支持复杂选择情况,如当用户可选视频和图片多类型时,可以设定选择视频后不可以选择图片,反之亦然。也可以设定视频和图片各自类型的选择数。
- 支持绑定Glide、Picasso、Imageloader等所有图片加载库(fresco暂不支持),EasyPhotos并没有对他们进行依赖,不必担心冲突和体积问题。
- 状态栏字体颜色智能适配,当状态栏颜色趋近于白色时,字体颜色智能处理为深色
- 内部处理运行时权限,使用者无需考虑权限问题
- 清晰预览超大图和长图
- 拼一张功能(可配置开关,可独立作为拼图使用)
- 原图功能(可配置开关)
- 广告填充(可配置开关)
- 过滤图片(图片宽度、图片高度、文件大小三个维度任意选择和搭配)
- 默认勾选图片(可配置)
- 图片预览(可全屏,可缩放)
- 支持动图gif显示,并支持只显示动图gif
- 支持视频video显示,并支持只显示视频video
- UI色值高度浓缩,仅为7种,自定义超简单
- 对Gif动图的处理(可配置开关是否显示,列表中以静态图+动图标识显示,预览大图时自动播放)
- 自带Bitmap相关方法(如添加水印、把View画成Bitmap、保存Bitmap等)
- 自带媒体库相关方法(如媒体文件更新到媒体库)
项目中需要处理用户通过相机、相册上传更新头像,使用EasyPhotos进行处理相机、相册。(EasyPhotos目前不支持裁剪 )
简单使用:
1.项目配置:
首先,在项目的 build.gradle(project)
文件里面添加:
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
最后,在你需要用到EasyPhotos的module中的 build.gradle(module)
文件里面添加:
dependencies {
implementation 'com.github.HuanTanSheng:EasyPhotos:3.1.3' //androidx版本,支持android 10、11,永久维护
//implementation 'com.github.HuanTanSheng:EasyPhotos:2.4.5' //还没有升级到androidx的同学可以用这个版本,但不支持android 10,暂停维护
}
另外还需要配置AndroidManifest.xml:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
package="com.huantansheng.easyphotos.demo">
<application
....
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.huantansheng.easyphotos.demo.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths_public" />
</provider>
</application>
</manifest>
file_paths_public.xml设置:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<paths>
<root-path
name="camera_photos"
path="" />
</paths>
</resources>
EasyPhotos的混淆:
-keep class com.huantansheng.easyphotos.models.** { *; }
2.项目中调用:
预加载相册扫描:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
if (PermissionUtil.checkAndRequestPermissionsInActivity(this,
Manifest.permission.READ_EXTERNAL_STORAGE)) {
preLoadAlbums();
}
}
/**
* 预加载相册扫描,可以增加点速度,写不写都行
* 该方法如果没有授权读取权限的话,是无效的,所以外部加不加权限控制都可以,加的话保证执行,不加也不影响程序正常使用。
*/
private void preLoadAlbums() {
EasyPhotos.preLoad(this);
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull final String[] permissions,
@NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
PermissionUtil.onPermissionResult(this, permissions, grantResults,
new PermissionUtil.PermissionCallBack() {
@Override
public void onSuccess() {
preLoadAlbums();
}
@Override
public void onShouldShow() {
}
@Override
public void onFailed() {
}
});
}
调用相机:(单独使用相机)
EasyPhotos.createCamera(getActivity(), true)//参数说明:上下文
.setFileProviderAuthority("com.huantansheng.easyphotos.demo.fileprovider")
.start(new SelectCallback() {
@Override
public void onResult(ArrayList<Photo> photos, boolean isOriginal) {
//获取file,进行对应操作
File file = new File(photos.get(0).path);
}
@Override
public void onCancel() {
}
});
调用相册:(相册单选,无相机功能) 注:需配置Glide为图片加载引擎GlideEngine
EasyPhotos.createAlbum(getActivity(), false,true, GlideEngine.getInstance())
.start(new SelectCallback() {
@Override
public void onResult(ArrayList<Photo> photos, boolean isOriginal) {
//获取file,进行对应操作
File file = new File(photos.get(0).path);
}
@Override
public void onCancel() {
}
});
其他功能请参考EasyPhotos Wiki