原生移动开发 / 系统课时

处理相机与媒体访问权限

处理相机与媒体访问权限

本课解决拍照、选图和读取已有媒体时“该申请什么权限”的问题。你将根据实际业务选择 Camera、Photo Picker、MediaStore 或旧系统兼容方案,避免继续用过大的存储权限。

学习目标

  • 能区分拍照、选图与批量读取媒体对应的系统能力
  • 能在现代 Android 中优先使用 Photo Picker,并正确处理返回的 URI
  • 能根据 Android 版本和业务需求选择必要的媒体读取权限

先按业务动作选能力

“用户选一张头像”和“应用扫描整个相册”是两类完全不同的需求。前者通常只需要让用户主动选择资源,后者才可能需要读取其他应用创建的媒体,因此不能看到图片相关功能就直接申请整库访问。

业务动作 优先方案 是否通常需要媒体读取权限
拍照并保存到应用自己的媒体记录 Camera + MediaStore 保存自己创建的媒体通常不需要存储读取权限
用户从相册选择一张或多张图片/视频 Photo Picker 通常不需要整库读取权限
应用自己的图库功能,需要查询其他应用创建的媒体 MediaStore Android 13+ 按图片、视频分别申请读取权限
Android 9 及更低设备访问共享媒体 MediaStore 等兼容方案 需要 READ_EXTERNAL_STORAGE

现代 Android 提供 Photo Picker,让用户把明确选中的媒体 URI 交给应用;它的目标就是避免为了“选一张图”而开放整个媒体库。Android 14 还引入了 Selected Photos Access,因此自建图库在需要完整控制权限范围时必须认真处理选中媒体与完整媒体访问的差异。([Android Developers][1])

拍照与选图不要混成一种权限

拍照本身和读取已有照片的权限边界不同。使用设备相机通常涉及 android.permission.CAMERA;把新照片保存到应用自己创建的媒体项时,在 Android 10 及以上并不需要额外的存储读取权限。只有当业务还要访问其他应用创建的媒体,才需要考虑相应的读取能力。([Android Developers][2])

例如,“拍照上传身份证”可以只申请相机权限并让拍摄结果进入应用处理链;“从手机相册选择身份证照片”则优先交给 Photo Picker,而不是先要求读取整个图库。

用 Photo Picker 完成选图

Jetpack Activity 提供 PickVisualMedia 和 PickMultipleVisualMedia,适合单选和多选。下面示例选择一张图片,并直接处理系统返回的 Uri。该代码依赖 androidx.activity 1.7.0 或更高版本,并放在 ComponentActivity 或其子类中。

kotlin
import android.os.Bundle
import android.util.Log
import androidx.activity.ComponentActivity
import androidx.activity.result.PickVisualMediaRequest
import androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia

class MainActivity : ComponentActivity() {
    private val pickImage = registerForActivityResult(PickVisualMedia()) { uri ->
        if (uri != null) {
            // 后续上传或读取都应围绕这个 content URI 进行。
            Log.d("PhotoPicker", "selected=$uri")
        } else {
            Log.d("PhotoPicker", "no media selected")
        }
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        pickImage.launch(
            PickVisualMediaRequest(PickVisualMedia.ImageOnly)
        )
    }
}

预期输出

text
selected=content://...

用户取消选择时,回调中的 uri 为 null,应用应把它当作正常取消流程,而不是异常。Photo Picker 不可用时,Jetpack 实现可以退回 ACTION_OPEN_DOCUMENT,因此业务代码仍然以 URI 为核心,而不是依赖具体 picker 界面。([Android Developers][1])

需要直接查询媒体库时再申请读取权限

当产品确实需要自己的图库、媒体索引或批量处理能力时,Android 13 引入了更细粒度的 READ_MEDIA_IMAGES 和 READ_MEDIA_VIDEO。应用只声明实际需要的类型,不要再把旧式“外部存储”权限当成所有媒体业务的默认入口。([Android Developers][3])

对于 Android 14 及以上且应用 target 34 或更高的场景,系统支持 Selected Photos Access。自建媒体选择器如果需要维持自己的 UI 和完整控制,就要考虑 READ_MEDIA_VISUAL_USER_SELECTED;不需要自建图库时,官方仍建议优先采用 Photo Picker。([Android Developers][4])

片段示例:以下 Manifest 声明只适合“确实需要查询其他应用创建的图片和视频”的应用,不能把它当作普通选图功能的默认配置。

xml
<manifest ...>
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
</manifest>

预期结果

text
应用可以针对实际的媒体类型设计运行时读取权限;仅声明权限不会自动获得用户授权。

兼容 Android 9 及更低版本时,还要根据实际最低系统版本处理 READ_EXTERNAL_STORAGE。Android 10 及以上则应优先遵循 scoped storage 和媒体集合模型,避免继续沿用旧式全盘文件访问思路。([Android Developers][3])

判断是否真的需要扩大权限

遇到媒体需求时,可以先问三个问题:第一,资源是否由用户主动选择;第二,应用是否需要读取大量其他应用创建的媒体;第三,是否必须使用自己的图库界面。只要第一个问题成立,通常先看 Photo Picker;只有后两个问题成立时,才继续评估 MediaStore 与细粒度媒体权限。

还要注意,MediaStore.Downloads 中其他应用创建的下载文件不属于普通图片选择场景,访问这类文档通常应考虑 Storage Access Framework。用户明确选择的文件或目录通过系统文档选择器获得 URI,也能避免无谓扩大存储权限。([Android Developers][5])

最终的实现原则很简单:**拍照就围绕相机,选图就优先 Photo Picker,批量查询媒体才申请对应的 READ_MEDIA_*,旧系统再单独处理兼容性。**这样既能减少授权范围,也能让权限失败时的降级路径更容易设计。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理相机与媒体访问权限

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通