Android 14适配实战：PictureSelector媒体权限升级指南-开发者社区

Android 14适配实战：PictureSelector媒体权限升级指南

【免费下载链接】PictureSelectorPicture Selector Library for Android or 图片选择器项目地址: https://gitcode.com/gh_mirrors/pict/PictureSelector

随着Android 14系统的全面推广，应用开发者在媒体访问权限方面面临着前所未有的挑战。Android 14媒体权限的进一步细化和严格管理，要求开发者必须及时更新其媒体访问逻辑。本文将基于PictureSelector库的最新更新，为大家提供一套完整的技术适配方案。

Android 14媒体权限的核心变化

你是否在应用升级到Android 14后遇到了图片选择功能异常？这很可能是由于新的权限模型导致的。Android 14对媒体权限进行了重大调整：

权限类型精细化：将媒体权限细分为图片、视频、音频三个独立维度
用户选择权限：新增READ_MEDIA_VISUAL_USER_SELECTED权限，用于访问用户明确选择的媒体文件
权限请求流程优化：改进了权限请求的用户体验，同时加强了隐私保护机制

这些变化直接影响到PictureSelector库的核心功能，包括图片选择、相机拍摄、媒体预览等关键模块。

PictureSelector库的架构升级

为了应对Android 14的挑战，PictureSelector库进行了全面的架构重构。新的框架设计采用了模块化思想，确保各功能组件的独立性和可扩展性。

从架构图中可以看出，PictureSelector 3.0版本将核心功能拆分为数据加载、图片引擎、自定义样式、相机功能、压缩引擎、裁剪引擎和结果回调七大模块。这种设计不仅适应了Android 14的新权限要求，还为开发者提供了更大的自定义空间。

快速配置步骤详解

依赖配置更新

首先，确保你的项目依赖已更新到支持Android 14的最新版本：

dependencies { // PictureSelector核心库 implementation 'io.github.lucksiege:pictureselector:v3.11.2' // 压缩功能模块 implementation 'io.github.lucksiege:compress:v3.11.2' // 图片裁剪模块 implementation 'io.github.lucksiege:ucrop:v3.11.2' // 相机功能模块 implementation 'io.github.lucksiege:camerax:v3.11.2' }

权限声明配置

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

<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" /> <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"/>

权限申请实战技巧

动态权限请求实现

在Activity或Fragment中实现权限请求逻辑：

// 检查并请求图片选择权限 private void requestImagePermission() { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) { // Android 14及以上版本 if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_IMAGES) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_MEDIA_IMAGES}, REQUEST_IMAGE_PERMISSION); } else { openImageSelector(); } } else { // Android 13及以下版本 if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_STORAGE_PERMISSION); } else { openImageSelector(); } } }

权限回调处理

正确处理权限请求结果：

@Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); if (requestCode == REQUEST_IMAGE_PERMISSION) { if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) { openImageSelector(); } else { // 权限被拒绝，显示提示信息 showPermissionDeniedDialog(); } }

界面风格定制方案

PictureSelector库提供了多种界面风格，满足不同应用场景的需求。

微信风格界面

微信风格的相册选择界面采用了层级化设计，顶部为透明悬浮标题栏，中部为相册分类列表，底部为图片预览区域。这种设计风格特别适合社交类应用。

PictureSelector.create(this) .openGallery(SelectMimeType.ofImage()) .setSelectorUIStyle(SelectorStyle.WECHAT_STYLE) .setImageEngine(GlideEngine.createGlideEngine()) .forResult(new OnResultCallbackListener<LocalMedia>() { @Override public void onResult(ArrayList<LocalMedia> result) { // 处理微信风格的选择结果 handleWeChatStyleResult(result); } });

默认风格界面

默认风格采用极简设计，无多余装饰，专注于核心功能。适合对UI设计要求较低的场景。

PictureSelector.create(this) .openGallery(SelectMimeType.ofImage()) .setSelectorUIStyle(SelectorStyle.DEFAULT_STYLE) .setImageEngine(GlideEngine.createGlideEngine()) .forResult(new OnResultCallbackListener<LocalMedia>() { @Override public void onResult(ArrayList<LocalMedia> result) { // 处理默认风格的选择结果 handleDefaultStyleResult(result); } });

相机功能适配策略

Android 14对相机权限也进行了调整，PictureSelector的CameraX模块已全面更新：

// 打开相机并处理拍摄结果 PictureSelector.create(this) .openCamera(SelectMimeType.ofImage()) .setCameraInterceptListener(new OnCameraInterceptListener() { @Override public void onCamera(Intent cameraIntent) { // 自定义相机拦截逻辑 customizeCameraBehavior(cameraIntent); } }) .forResult(new OnResultCallbackListener<LocalMedia>() { @Override public void onResult(ArrayList<LocalMedia> result) { // 处理相机拍摄结果 handleCameraResult(result); } });

媒体预览功能优化

媒体预览功能在Android 14上得到了显著提升，支持图片、视频和音频的流畅预览。

视频预览实现

PictureSelector.create(this) .openPreview() .setImageEngine(GlideEngine.createGlideEngine()) .setVideoPlayerEngine(ExoPlayerEngine.createExoPlayerEngine()) .forResult(new OnResultCallbackListener<LocalMedia>() { @Override public void onResult(ArrayList<LocalMedia> result) { // 处理视频预览结果 handleVideoPreviewResult(result); } });