Android AlbumCameraRecorder 开源 多媒体操作库 （包含 视频 音频 图片 ）

该版本是基于AndroidX版本开发的分支。版本号后面带着X的都是属于基于AndroidX版本开发。

目前已经投入到正式项目中使用。

有任何建议或者想添加的功能，都可提在Issues

一个高效的多媒体支持操作库，可多方面的简单配置操作拍照、相册、录制、录音等功能。

也支持配套使用的展示图片、视频、音频的九宫格功能。

本开源库的部分代码来自Matisse.

非常感谢知乎提供的这么棒的开源项目！

非X版本分支

非X库版本,已经停止维护(https://github.com/zhongjhATC/AlbumCameraRecorder/tree/master)

特性

• 支持自定义样式.支持更换里面的相关按钮.
• 支持相册、录制、录音等三合一功能（类似抖音等），并且也可以通过配置只独立出其中一个功能.
• 虽然功能很多，但是可以按照所需功能来引入某些库
• 丰富的回调接口和调试信息,可利用现有API实现丰富的效果.
• 兼容性强，不管是低版本的4.1还是目前最新版本的Android 11,都进行了相关兼容处理
• 支持所有图片读取处理自定义，例如可自定义glide、Fresco等等都可以
• 支持从相册选择图片
• 支持相册按照手机文件区分不同的文件夹选择
• 自定义性强，支持各种自定义最多选多少张图片、视频等等，也支持只显示自定义文件大小
• 支持自定义相册的样式，颜色，大小等等
• 录制拍照时支持闪光灯、前后摄像头切换
• 录制拍照时支持双指触摸放大缩小，支持单指上下滑动控制亮度
• 录制拍照长按按钮等所有UI可自定义，全是svg图片可以很好的处理动画细节
• 录制支持分段录制，以后还会加入视频编辑
• 图片编辑支持颜色涂鸦、输入文字、马赛克处理、旋转、裁剪等处理
• 支持录音处理
• 所有录制拍照都经过了压缩处理
• 1.0.19X以后的版本兼容Android Q版本,如果打算保留自己项目sdk28的，可以只保留1.0.18X

引入

Step 1. Add the JitPack repository to your build file

allprojects {
    repositories {
        ...
        maven { url 'https://www.jitpack.io' }
    }
}

Step 2. Add the dependency

dependencies {
     implementation 'com.github.zhongjhATC.AlbumCameraRecorder:albumCameraRecorderCommon:1.0.30X'        // 公共库，必须使用此库
     implementation 'com.github.zhongjhATC.AlbumCameraRecorder:multilibrary:1.0.30X'      // 核心lib，调用显示相册、录屏、录音等
     implementation 'com.github.zhongjhATC.AlbumCameraRecorder:progresslibrary:1.0.30X' // 配套使用，主要用于获取数据后进行相关显示，相应的上传进度显示，如果你只需要获取照片录像录音等数据，自行写获取后呈现方式，可以不需要是用这个
     implementation 'com.github.zhongjhATC.AlbumCameraRecorder:imageedit:1.0.30X'  // 配套编辑图片使用
     implementation 'com.github.zhongjhATC.AlbumCameraRecorder:videoedit:1.0.30X'  // 配套编辑视频使用
}

快照

Demonstration.gif

市场上常用手机兼容测试

100%通过兼容测试报告.

image

使用

启动多媒体相关功能

    // 拍摄有关设置
    CameraSetting cameraSetting = new CameraSetting();
    // 支持的类型：图片，视频
    cameraSetting.mimeTypeSet(MimeType.ofAll());

    // 相册
    mAlbumSetting = new AlbumSetting(false)
            // 支持的类型：图片，视频
            .mimeTypeSet(MimeType.ofAll())
            // 是否显示多选图片的数字
            .countable(true)
            // 自定义过滤器
            .addFilter(new GifSizeFilter(320, 320, 5 * BaseFilter.K * BaseFilter.K))
            // 开启原图
            .originalEnable(true)
            // 最大原图size,仅当originalEnable为true的时候才有效
            .maxOriginalSize(10);

    // 录音机
    RecorderSetting recorderSetting = new RecorderSetting();

    // 全局
    mGlobalSetting = MultiMediaSetting.from(MainSimpleActivity.this).choose(MimeType.ofAll());

    if (mBinding.cbAlbum.isChecked()){
        // 开启相册功能
        mGlobalSetting.albumSetting(mAlbumSetting);
    }
    if (mBinding.cbCamera.isChecked()){
        // 开启拍摄功能
        mGlobalSetting.cameraSetting(cameraSetting);
    }
    if (mBinding.cbRecorder.isChecked()){
        // 开启录音功能
        mGlobalSetting.recorderSetting(recorderSetting);
    }

    mGlobalSetting
            .setOnMainListener(errorMessage -> {
                Log.d(TAG, errorMessage);
                Toast.makeText(MainSimpleActivity.this.getApplicationContext(), errorMessage, Toast.LENGTH_LONG).show();
            })
            // 设置路径和7.0保护路径等等
            .allStrategy(new SaveStrategy(true, "com.zhongjh.cameraapp.fileprovider", "aabb"))
            // for glide-V4
            .imageEngine(new Glide4Engine())
            // 最大10张图片或者最大1个视频
            .maxSelectablePerMediaType(5 - alreadyImageCount, 1 - alreadyVideoCount, 1 - alreadyAudioCount)
            .forResult(REQUEST_CODE_CHOOSE);

获取相关返回的数据

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode != RESULT_OK)
        return;
    switch (requestCode) {
        case REQUEST_CODE_PREVIEW:
            ```
        case REQUEST_CODE_CHOOSE:
            // 获取类型，根据类型设置不同的事情
            switch (MultiMediaSetting.obtainMultimediaType(data)) {
                case MultimediaTypes.PICTURE:
                    // 图片
                    List path = MultiMediaSetting.obtainResult(data);
                    mBinding.mplImageList.addImagesStartUpload(path);
                    break;
                case MultimediaTypes.VIDEO:
                    // 录像
                    List videoPath = MultiMediaSetting.obtainResult(data);
                    mBinding.mplImageList.addVideoStartUpload(videoPath);
                    break;
                case MultimediaTypes.AUDIO:
                    // 语音
                    RecordingItem recordingItem = MultiMediaSetting.obtainRecordingItemResult(data);
                    mBinding.mplImageList.addAudioStartUpload(recordingItem.getFilePath(), recordingItem.getLength());
                    break;
                case MultimediaTypes.BLEND:
                    // 混合类型，意思是图片可能跟录像在一起.
                    List blends = MultiMediaSetting.obtainResult(data);
                    List images = new ArrayList<>();
                    List videos = new ArrayList<>();
                    // 循环判断类型
                    for (Uri uri : blends) {
                        DocumentFile documentFile = DocumentFile.fromSingleUri(getBaseContext(), uri);
                        if (documentFile.getType().startsWith("image")) {
                            images.add(uri);
                        } else if (documentFile.getType().startsWith("video")) {
                            videos.add(uri);
                        }
                    }
                    // 分别上传图片和视频
                    mBinding.mplImageList.addUrisStartUpload(images);
                    mBinding.mplImageList.addVideoStartUpload(videos);
                    break;
            }
            break;
    }
}

如果你需要用到九宫格展览数据，具体可以看相关代码.

相关API,更多API和支持持续丰富加入

• 调用多媒体的公共配置API.
• 调用多媒体的相册配置API.
• 调用多媒体的录制配置API.
• 调用多媒体的录音配置API.
• 多媒体UI相关属性配置

如果你使用展示的九宫库，那么下面这些api对你也有用

• 九宫格相关API.
• 九宫格相关事件.
• 九宫格相关属性，配置UI等等

历史更新

从1.0.1版本开始总结的历史更新.

apk直接体验下载

• 1.0.0版本，跟当前最新代码版本可能会有稍许不同
  [图片上传失败...(image-fc6995-1621474389221)]

• 链接下载地址：https://fir.im/s9b6?release_id=5c84dcd3ca87a807f7ef5181&fir_source=%E7%89%88%E6%9C%AC1&fir_campaign=%E7%89%88%E6%9C%AC1

写在最后

1. 觉得好用的欢迎给个Star（GitHub）

2. 发现任何BUG欢迎留言或者留个Issues（Issues）

3. 任何转载请注明出处

QQ群915053430 此群于2021.4.28新建。用于解决问题，确保当前库是可以兼容最新版本，当然也坚持打造最万能的多媒体操作库

github地址：
https://github.com/zhongjhATC/AlbumCameraRecorder

这个库会长期随着公司项目、日记diary使用维护。