图片选择器开源项目使用教程

图片选择器开源项目使用教程

PictureSelector Picture Selector Library for Android or 图片选择器 项目地址: https://gitcode.com/gh_mirrors/pict/PictureSelector

1. 项目介绍

本项目是一个适用于Android平台的图片选择器库，名为PictureSelector。它支持从相册获取图片、视频和音频，支持单张或多张图片的裁剪、压缩、主题自定义配置等功能。该框架适合Android 5.0及以上系统，是一个动态访问的开源图片选择框架。

2. 项目快速启动

添加依赖

首先，在项目的build.gradle文件中添加以下依赖：

repositories {
    google()
    mavenCentral()
}

dependencies {
    // PictureSelector基础依赖（必须）
    implementation 'io.github.lucksiege:pictureselector:v3.11.2'
    // 图片压缩库（非必须）
    implementation 'io.github.lucksiege:compress:v3.11.2'
    // uCrop库（非必须）
    implementation 'io.github.lucksiege:ucrop:v3.11.2'
    // 简单的Camerax库（非必须）
    implementation 'io.github.lucksiege:camerax:v3.11.2'
}

权限配置

在AndroidManifest.xml中添加必要的权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_MEDIA_STORAGE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.VIBRATE" />

<!-- Android 13版本适配，细化存储权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

示例代码

以下是一个简单的图片选择示例：

PictureSelector.create(this)
    .openGallery(SelectMimeType.ofImage())
    .setImageEngine(GlideEngine.createGlideEngine())
    .forResult(new OnResultCallbackListener<LocalMedia>() {
        @Override
        public void onResult(ArrayList<LocalMedia> result) {
            // 处理选择的结果
        }

        @Override
        public void onCancel() {
            // 处理取消操作
        }
    });

3. 应用案例和最佳实践

获取图片

PictureSelector.create(this)
    .openGallery(SelectMimeType.ofImage())
    .setImageEngine(GlideEngine.createGlideEngine())
    .forResult(new OnResultCallbackListener<LocalMedia>() {
        @Override
        public void onResult(ArrayList<LocalMedia> result) {
            // 处理选择的结果
        }

        @Override
        public void onCancel() {
            // 处理取消操作
        }
    });

使用系统相册

PictureSelector.create(this)
    .openSystemGallery(SelectMimeType.ofImage())
    .forResult(new OnResultCallbackListener<LocalMedia>() {
        @Override
        public void onResult(ArrayList<LocalMedia> result) {
            // 处理选择的结果
        }

        @Override
        public void onCancel() {
            // 处理取消操作
        }
    });

仅使用相机

PictureSelector.create(this)
    .openCamera(SelectMimeType.ofImage())
    .forResult(new OnResultCallbackListener<LocalMedia>() {
        @Override
        public void onResult(ArrayList<LocalMedia> result) {
            // 处理选择的结果
        }

        @Override
        public void onCancel() {
            // 处理取消操作
        }
    });

预览图片、视频、音频

PictureSelector.create(this)
    .openPreview()
    .setImageEngine(GlideEngine.createGlideEngine());

4. 典型生态项目

本项目作为一个开源图片选择器，可以与多个生态项目配合使用，例如：

• 图片加载引擎：Glide、Picasso、Coil等
• 视频播放器：ExoPlayer、ijkPlayer等

通过这些生态项目的结合使用，可以进一步丰富应用的功能和用户体验。

PictureSelector Picture Selector Library for Android or 图片选择器 项目地址: https://gitcode.com/gh_mirrors/pict/PictureSelector