PhotoSelector

自定义相册图片、视频视频选择，提供简单好用的自定义相册图片视频选择工具。

简介

打造最简单易用的自定义相册库，提供图片选择、视频选择、自动去重、图片视频预览、调用系统相机拍照、调用系统相机录像等功能。
该库基于Androidx，没有迁移到Androidx的同学可能无法使用，请谅解。

主要功能：

1. 图片和视频选择。支持只选择图片、只选择视频、同时选择图片和视频。

2. 图片视频预览。可直接预览本地或网络上的图片和视频。视频播放采用的是Google的ExoPlayer。

3. 调起相机拍照。

4. 调起相机录像。

主要特点：

1.自带Android6.0以上的动态权限校验，开发者无需关心权限问题。

2.Callback的调用方式，使用PhotoSelector打开图片库选择图片或视频后可直接在回调中拿到结果，逻辑更清晰代码更简洁，一行代码即可实现图片选择的功能。

3.支持同时选择多张图片或多个视频(可手动设置最大个数，默认为9个)。

4.自动去重，自动回显已经选中了的图片或视频，防止选择一样的资源(默认支持:默认使用当前Activity或则Fragment的hashCode作为id,也可手动设置id，可手动设置关闭去重，如果想关闭去重id为PhotoSelector.ID_REPEATABLE即可)。

更新

1.0.0 优化使用修复Bug。

1. 修复相册视频列表中因视频文件太小或出现0kb文件而导致闪退的Bug。
2. 优化单选时的处理，具体如下：
   • 当 maxLength == 1 时用户点击选择框自动结束选择，并返回(通过回调)用户选择的结果。
   • 当 maxLength == 1 时底部的完成按钮变成标签样式。
   • 对所有openXXXSelector方法增加openXXXSelectorSingle方法，改方法的回调中只会返回一个Photo对象，不再返回List<Photo>，使用起来更加方便。
3. 增加了英文系统的国际化适配。

0.9.3 修复拍照后没有默认返回压缩后的图片的Bug。

0.9.2 修复由于在某些情况下onComposeFinished方法没有被调用而导致按下完成按钮后一直处于loading的状态的Bug。

0.9.1 变更PhotoSelectorActivity的包路径，变更后再清单文件注册方式如下：。

<activity android:name="com.kelin.photoselector.PhotoSelectorActivity"
          android:configChanges="screenSize|orientation"/>

0.9.0 将Activity替换为Fragment并增加视频播放功能(使用Google的ExoPlayer)。

1.完成重构，将所有功能的具体实现都移至Fragment，并舍弃PhotoPreviewActivity。这样做的好处就是即使后来再扩展新的页面，使用者也无需再清单文件中增加新的Activity。

2.基于Google的ExoPlayer库增加视频播放功能，支持网络视频和本地视频。原来调用系统播放视频的功能依然保留。调用方式如下：

//使用Google的ExoPlayer播放视频。
PhotoSelector.playVideo(activity, uri)
//使用Android系统的播放视频功能播放视频。
PhotoSelector.playVideoWithSystem(activity, uri)

0.8.1

优化压缩之后的处理逻辑以及优化代码。

1.解决选择图片时如果在选中之后立即点击完成按钮将会有可能导致调用者无法拿到压缩后的图片的问题。

2.优化代码逻辑，更加稳定。

0.8.0

优化图片预览交互体检增加自动压缩功能，撤销0.7.1中的自动旋转的配置。

1. 优化代码逻辑，使其更加稳定。

2. 图片预览时用户可以单击图片退出预览，优化交互体验。

3. 增加自动压缩功能，您可以在init方法中进行配置是否需要自动压缩，同时撤销了自动旋转的配置，开启自动压缩则会同时开启自动旋转。开启方式如下：

PhotoSelector.init(this,"${packageName}.fileProvider", true)

0.7.1

解决部分机型拍照后会图片会旋转的问题，解决办法为选择图片或拍照时自动纠正图片角度。自动纠正功能默认不会开启，如要手动开启需要在init方法中设置，例如：

PhotoSelector.init(this,"${packageName}.fileProvider", true)

0.7.0

优化去重逻辑，拍照或拍视频后再打开自定义相册会默认勾选(依然是由id决定)

0.6.0

PhotoSelector 增加 removeSelected 方法。

1. 增加从外部撤销选中的功能，使得使用者可以在选择完毕后调用方法对已选中的进行撤销选中的操作(应对不同的使用场景)。
2. 修复图片预览时因使用了错误的缩放模式而导致的图片显示不正常的Bug。

下载

第一步：添加 JitPack 仓库到你项目根目录的 gradle 文件中。

allprojects {
    repositories {
        //...省略N行代码
        maven { url  https://jitpack.io  }
    }
}

第二步：app的gradle中添加这个依赖。

dependencies {
    implementation  com.github.kelinZhou:PhotoSelector:${last version here!} 
}

第三步：打开Java8支持。

如果尚未启用，则需要在所有 build.gradle文件中打开Java 8支持，由于视频播放是使用的ExoPlayer库所以必须要打开Java8的支持。方法是在以下android部分添加以下内容：

android {
    //...省略N行代码
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

第四步：如果你要适配AndroidQ，那么你需要在清单文件中增加requestLegacyExternalStorage。

Android Q 默认开启沙箱模式 导致出现文件读写失败。

android:requestLegacyExternalStorage="true"

效果图

使用

第一步：添加PhotoSelectorActivity到你的清单文件中。

<activity android:name="com.kelin.photoselector.PhotoSelectorActivity"
          android:configChanges="screenSize|orientation"/>

第二步：AndroidManifest.xml清单文件中添加PhotoSelector所需要的权限。

<!--网络权限，如果你需要预览网络图片或视频则必须添加改权限-->
<uses-permission android:name="android.permission.INTERNET" />
<!--相机权限，拍照、录像时的必要权限-->
<uses-permission android:name="android.permission.CAMERA" />
<!--录制视频权限，录像时的必要权限-->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!--读取外部存储权限，PhotoSelector库中所有功能都会使用到的权限-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!--写入外部存储权限，PhotoSelector库中所有功能都会使用到的权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

完成上面两步后就可以开始使用了。整个库的核心类就一个“`PhotoSelector“。你只需要使用它的相应方法就能完成相应功能。具体Api如下：

1. 拍摄照片

PhotoSelector.takePhoto(context){
    if (it != null) {
        //do something…
    } else {
        Toast.makeText(applicationContext, "拍照失败", Toast.LENGTH_SHORT).show()
    }
}

2. 拍摄视频

PhotoSelector.takeVideo(context){
    if (it != null) {
        //do something…
    } else {
        Toast.makeText(applicationContext, "录像失败", Toast.LENGTH_SHORT).show()
    }
}

3. 选择图片(单选)

PhotoSelector.openPhotoSelectorSingle(this) { photo ->
                if (photo == null) {
                    Toast.makeText(this, "选择已被撤销", Toast.LENGTH_SHORT).show()
                } else {
                    //do something...
                }
            }

4. 选择图片(多选)

PhotoSelector.openPhotoSelector(context) { photos ->
    if (photos.isNullOrEmpty()) {
        Toast.makeText(context, "选择已被撤销", Toast.LENGTH_SHORT).show()
    } else {
        //do something…
    }
}

5. 选择视频(单选)

PhotoSelector.openVideoSelectorSingle(this) { photo ->
                if (photo == null) {
                    Toast.makeText(this, "选择已被撤销", Toast.LENGTH_SHORT).show()
                } else {
                    //do something...
                }
            }

6. 选择视频(多选)

PhotoSelector.openVideoSelector(context) { photos ->
    if (photos.isNullOrEmpty()) {
        Toast.makeText(context, "选择已被撤销", Toast.LENGTH_SHORT).show()
    } else {
        //do something…
    }
}

7. 选择图片和视频(单选)

PhotoSelector.openPictureSelectorSingle(this) { photo ->
    when {
        photo == null -> {
            Toast.makeText(this, "选择已被撤销", Toast.LENGTH_SHORT).show()
        }
        photo.isVideo -> {
            PhotoSelector.playVideo(this, photo)
        }
        else -> {
            PhotoSelector.openPicturePreviewPage(this, listOf(photo))
        }
    }
}

8. 选择图片和视频(多选)

PhotoSelector.openPictureSelector(context) { photos ->
    if (photos.isNullOrEmpty()) {
        Toast.makeText(context, "选择已被撤销", Toast.LENGTH_SHORT).show()
    } else {
        //do something…
    }
}

9. 图片或视频预览，支持本地图片已经网络图片。

PhotoSelector.openPicturePreviewPage(context, photos)

10. 播放视频，支持网络视频以及本地视频。

PhotoSelector.playVideo(activity, "url or filePath")

11. 使用系统自带的播放功能播放视频，支持网络视频以及本队视频。

PhotoSelector.playVideoWithSystem(activity, "url or filePath")

---

最后奉上GitHub地址。如果您觉得有用，还望给个Star，您的鼓励将是我继续创作和维护的动力。感谢！！！