自定义相册图片、视频视频选择，提供简单好用的自定义相册图片视频选择工具。
打造最简单易用的自定义相册库，提供图片选择、视频选择、自动去重、图片视频预览、调用系统相机拍照、调用系统相机录像等功能。 该库基于Androidx，没有迁移到Androidx的同学可能无法使用，请谅解。
-
图片和视频选择。支持只选择图片、只选择视频、同时选择图片和视频。
-
图片视频预览。可直接预览本地或网络上的图片和视频。视频播放采用的是Google的ExoPlayer。
-
调起相机拍照。
-
调起相机录像。
1.自带Android6.0以上的动态权限校验，开发者无需关心权限问题。
2.Callback的调用方式，使用PhotoSelector打开图片库选择图片或视频后可直接在回调中拿到结果，逻辑更清晰代码更简洁，一行代码即可实现图片选择的功能。
3.支持同时选择多张图片或多个视频(可手动设置最大个数，默认为9个)。
4.自动去重，自动回显已经选中了的图片或视频，防止选择相同的资源(默认支持:默认使用当前Activity或则Fragment的hashCode作为id,也可手动设置id，可手动设置关闭去重,id为-1即可)。
- 修复图片预览功能如果预览图片过多会崩溃的Bug。
- 修复图片未全部加载成功时退出页面会导致崩溃的Bug。
- 优化图片过多时的加载卡顿问题。
- 优化同时设置maxSize和maxDuration时maxDuration无法生效的问题(如设置了maxDuration则不再校验视频文件的size，视频文件优先已maxDuration为准)。
- 修复ClassCaseException。
- Coil图片加载框架
- Glide图片加载框架
- 升级OkPermission框架。
- 将Glide图片加载框架替换为Coil。
- ImageLoader为Coil的核心，用户需要在初始化之前调用代码为Coil设置ImageLoader，例如
Coil.setImageLoader(imageLoader)或Coil.setImageLoader(imageLoaderFactory) - 也可以直接让Application实现
ImageLoaderFactory接口并重写newImageLoader方法，例如下面的代码：
class App : Application(), ImageLoaderFactory {
override fun onCreate() {
super.onCreate()
//初始化PhotoSelector。
PhotoSelector.init(this,"${packageName}.fileProvider", true, albumTakePictureEnable = false)
}
override fun newImageLoader(): ImageLoader {
return ImageLoader.Builder(this)
.components {
//添加GIF支持
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
add(ImageDecoderDecoder.Factory())
} else {
add(GifDecoder.Factory())
}
//添加视频加载为图片的支持
add(VideoFrameDecoder.Factory())
}
.build()
}
}- 适配Android13
- 升级ExoPlayer到2.18.5
- 升级Kotlin版本到1.9.22
- 升级AGP到8.2
- 修复相册视频列表中因视频文件太小或出现0kb文件而导致闪退的Bug。
- 优化单选时的处理，具体如下：
- 当 maxLength == 1 时用户点击选择框自动结束选择，并返回(通过回调)用户选择的结果。
- 当 maxLength == 1 时底部的完成按钮变成标签样式。
- 对所有openXXXSelector方法增加openXXXSelectorSingle方法，改方法的回调中只会返回一个Photo对象，不再返回List，使用起来更加方便。
- 增加了英文系统的国际化适配。
<activity android:name="com.kelin.photoselector.PhotoSelectorActivity"
android:configChanges="screenSize|orientation"/>1.完成重构，将所有功能的具体实现都移至Fragment，并舍弃PhotoPreviewActivity。这样做的好处就是即使以后再扩展新的页面，使用者也无需再清单文件中增加新的Activity。
2.基于Google的ExoPlayer库增加视频播放功能，支持网络视频和本地视频。原来调用系统播放视频的功能依然保留。调用方式如下：
//使用Google的ExoPlayer播放视频。
PhotoSelector.playVideo(activity, uri)
//使用Android系统的播放视频功能播放视频。
PhotoSelector.playVideoWithSystem(activity, uri)优化压缩之后的处理逻辑以及优化代码。
1.解决选择图片时如果在选中之后立即点击完成按钮将会有可能导致调用者无法拿到压缩后的图片的问题。
2.优化代码逻辑，更加稳定。
优化图片预览交互体检增加自动压缩功能，取消0.7.1中的自动旋转的配置。
-
优化代码逻辑，使其更加稳定。
-
图片预览时用户可以单击图片退出预览，优化交互体验。
-
增加自动压缩功能，您可以在init方法中进行配置是否需要自动压缩，同时取消了自动旋转的配置，开启自动压缩则会同时开启自动旋转。开启方式如下：
PhotoSelector.init(this,"${packageName}.fileProvider", true)解决部分机型拍照后会图片会旋转的问题，解决办法为选择图片或拍照时自动纠正图片角度。自动纠正功能默认不会开启，如要手动开启需要在init方法中设置，例如：
PhotoSelector.init(this,"${packageName}.fileProvider", true)优化去重逻辑，拍照或拍视频后再打开自定义相册会默认勾选(依然是由id决定)
PhotoSelector 增加 removeSelected 方法。
1. 增加从外部取消选中的功能，使得使用者可以在选择完毕后调用方法对已选中的进行取消选中的操作(应对不同的使用场景)。
2. 修复图片预览时因使用了错误的缩放模式而导致的图片显示不正常的Bug。
点击下载或扫码下载DemoApk
allprojects {
repositories {
//...省略N行代码
maven { url 'https://jitpack.io' }
}
}dependencies {
implementation 'com.github.kelinZhou:PhotoSelector:${last version here!}'
}如果尚未启用，则需要在所有 build.gradle文件中打开Java 8支持，由于视频播放是使用的ExoPlayer库所以必须要打开Java8的支持。方法是在以下android部分添加以下内容：
android {
//...省略N行代码
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
<activity android:name="com.kelin.photoselector.PhotoSelectorActivity"
android:configChanges="screenSize|orientation"/><!--网络权限，如果你需要预览网络图片或视频则必须添加改权限-->
<uses-permission android:name="android.permission.INTERNET" />
<!--相机权限，拍照、录像时的必要权限-->
<uses-permission android:name="android.permission.CAMERA" />
<!--读取外部存储权限，PhotoSelector库中所有功能都会使用到的权限-->
<uses-permission
android:name="android.permission.READ_EXTERNAL_STORAGE"
android:maxSdkVersion="32" />
<!--写入外部存储权限，PhotoSelector库中所有功能都会使用到的权限-->
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="32"
tools:ignore="ScopedStorage" />
<!--访问照片权限-->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!--访问视频权限-->
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />完成上面两步后就可以开始使用了。整个库的核心类就一个```PhotoSelector``。你只需要使用它的相应方法就能完成相应功能。具体Api如下：
**注意：**在华为的HarmonyOS中可能会出现无法成功拉起相机的情况：如果出现则在AndroidManifest.xml清单文件中加入以下代码：
<manifest
...>
<queries>
<package android:name="com.huawei.camera" /> //启用华为相机
</queries>
</manifest>- 拍摄照片
PhotoSelector.takePhoto(context){
if (it != null) {
//do something…
} else {
Toast.makeText(applicationContext, "拍照失败", Toast.LENGTH_SHORT).show()
}
}- 拍摄视频
PhotoSelector.takeVideo(context){
if (it != null) {
//do something…
} else {
Toast.makeText(applicationContext, "录像失败", Toast.LENGTH_SHORT).show()
}
}- 选择图片 使用自定义相册
PhotoSelector.withSelectorAlbum(activity, AlbumType.PHOTO) {
selectId = activity.hashCode() //设置过滤条件，当前Activity中不能选择重复的图片，仅自定义相册支持。
maxSize = 5F //设置过滤大于5M的图片，仅自定义相册支持。
selectAll(9){ photos ->
if (photos.isEmpty()) {
Toast.makeText(context, "选择已被取消", Toast.LENGTH_SHORT).show()
} else {
//do something…
}
}
}使用系统相册
PhotoSelector.withSysAlbum(activity, AlbumType.PHOTO) {
selectAll(9){ photos ->
if (photos.isEmpty()) {
Toast.makeText(context, "选择已被取消", Toast.LENGTH_SHORT).show()
} else {
//do something…
}
}
}- 选择视频 使用自定义相册
PhotoSelector.withSelectorAlbum(activity, AlbumType.VIDEO) {
maxDuration = 30 //过滤所有视频长度超过30秒的视频，仅自定义相册支持。
maxSize = 20 //设置过滤大于20M的视频，仅自定义相册支持。
selectAll(9){ photos ->
if (photos.isEmpty()) {
Toast.makeText(context, "选择已被取消", Toast.LENGTH_SHORT).show()
} else {
//do something…
}
}
}使用系统相册
PhotoSelector.withSysAlbum(activity, AlbumType.VIDEO) {
selectAll(9){ photos ->
if (photos.isEmpty()) {
Toast.makeText(context, "选择已被取消", Toast.LENGTH_SHORT).show()
} else {
//do something…
}
}
}-
选择图片和视频 图片和视频同时选择时与仅选择图片或视频是的使用方法一致，仅需要把
AlbumType设置为AlbumType.PHOTO_VIDEO即可。 -
单选 很多使用选择图片仅需要单选，单选时不要调用
selectAll方法，而是调用select方法，下面已选择图片举例：
使用自定义相册
PhotoSelector.withSelectorAlbum(activity, AlbumType.PHOTO) {
select{ photo ->
if (photo == null) {
Toast.makeText(context, "选择已被取消", Toast.LENGTH_SHORT).show()
} else {
//do something…
}
}
}使用系统相册
PhotoSelector.withSysAlbum(activity, AlbumType.PHOTO) {
select{ photo ->
if (photo == null) {
Toast.makeText(context, "选择已被取消", Toast.LENGTH_SHORT).show()
} else {
//do something…
}
}
}- 图片或视频预览，支持本地图片已经网络图片。
PhotoSelector.openPicturePreviewPage(
context, listOf(
PhotoImpl("https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1594798038139&di=fa8ec9fefaa0a63f691f61b97a7973c5&imgtype=0&src=http%3A%2F%2Fimg0.imgtn.bdimg.com%2Fit%2Fu%3D2811584385%2C4107951140%26fm%3D214%26gp%3D0.jpg"),
PhotoImpl("https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1594798037700&di=13c506d61f14c08e9b28a189118133ab&imgtype=0&src=http%3A%2F%2Fattach.bbs.miui.com%2Fforum%2F201205%2F07%2F200343cx0b5wwqdp0wbdb3.jpg"),
PhotoImpl("https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1594798037699&di=a6b5909d028e1b6f11aaa37429f4ca67&imgtype=0&src=http%3A%2F%2Fgss0.baidu.com%2F-vo3dSag_xI4khGko9WTAnF6hhy%2Fzhidao%2Fpic%2Fitem%2Fa8014c086e061d954f51db5679f40ad162d9ca4d.jpg"),
PhotoImpl("https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1594798037700&di=7b4c89fdcb5a1ede4f13ca642d743907&imgtype=0&src=http%3A%2F%2Fb-ssl.duitang.com%2Fuploads%2Fitem%2F201511%2F28%2F20151128182741_Mywkf.png")
)
)- 播放视频，支持网络视频以及本地视频。
PhotoSelector.playVideo(activity, "url or filePath")- 使用系统自带的播放功能播放视频，支持网络视频以及本队视频。
PhotoSelector.playVideoWithSystem(activity, "url or filePath")Copyright 2016 kelin410@163.com
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.