第2章 权限体系基础认知
Android权限等级分类、ExoPlayer依赖权限清单、运行时权限与清单声明差异

现象识别：权限不足时ExoPlayer播放失败的表现

当ExoPlayer缺少必要权限时，播放行为会出现以下可观察的异常现象。请对照下表快速判断是否属于权限问题：

数据采集：权限相关信息的获取方法

排查权限不足前提是准确采集以下三类数据。每类数据的获取方式与关注点如下：

1. 应用私有权限状态 —— 通过 ContextCompat.checkSelfPermission() 或 PackageManager.checkPermission() 获取当前授予状态。
2. AndroidManifest.xml 声明 —— 检查 <uses-permission> 标签是否包含了所有 ExoPlayer 工作所需的权限。
3. ExoPlayer 内部错误回调 —— 在 Player.Listener.onPlayerError 中获取 ExoPlaybackException 的 cause，提取权限相关异常。

// 典型数据采集代码片段（仅示例，非完整）
int permissionCheck = ContextCompat.checkSelfPermission(context, Manifest.permission.READ_EXTERNAL_STORAGE);
if (permissionCheck == PackageManager.PERMISSION_DENIED) {
    Log.w("ExoPlayer", "存储权限未授予，可能影响本地播放");
}

同时导出 adb shell dumpsys package com.your.package 可查看已声明的权限清单。

原因定位：Android权限等级与ExoPlayer依赖清单

Android 权限按照保护等级分为三类，ExoPlayer 常用的权限恰好覆盖这三类。理解等级差异是定位问题的核心：

ExoPlayer 依赖权限详细清单（完整排查表）

根据 ExoPlayer 官方文档及常见使用场景，按功能模块整理依赖权限：

运行时权限与清单声明的差异（定位关键）

很多权限问题源于开发者混淆了“声明”与“请求”两个动作。差异比对：

修复动作：按故障树节点执行对应操作

根据故障树定位到具体节点后，执行下表对应的修复步骤：

requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_CODE);

if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
    // 重新初始化ExoPlayer
} else {
    // 提示用户手动开启权限
}

复测：验证权限修复后的播放能力

执行以下复测清单，确保权限问题完全解决：

• 单元检测：在播放前添加 checkSelfPermission 日志，确认权限状态为 GRANTED。
• 功能验证：播放受影响的媒体资源（本地文件/网络流），观察是否能正常进入 STATE_READY 并开始渲染。
• 边界测试：拒绝权限后重新打开应用，确认应用不会崩溃且能给出友好提示。
• 自动化回归：使用 AndroidTest 注入拒绝的权限状态，测试播放降级逻辑。

// 复测时可在Player.Listener中捕获错误
player.addListener(new Player.Listener() {
    @Override
    public void onPlayerError(ExoPlaybackException error) {
        Throwable cause = error.getCause();
        if (cause instanceof PermissionException || 
            (cause.getMessage() != null && cause.getMessage().contains("Permission denied"))) {
            // 权限问题未完全修复
        }
    }
});

预防：建立ExoPlayer权限基线

在项目早期将这些规则固化为团队规范，防止权限问题反复出现：

1. 权限清单模板：维护一个标准 AndroidManifest.xml 片段（见下），每次新建ExoPlayer功能时直接复制。
2. 运行时请求封装：制作统一的 ExoPlayerPermissionHelper 类，集中处理危险权限请求及回调。
3. 代码审查检查项：每次MR必须确认：
   - 新引入的 MediaSource 是否需要额外权限？
   - 是否遗漏了 AndroidManifest.xml 中的声明？
   - 危险权限的运行时请求和拒绝处理是否完整？
4. CI 检查：使用 lint 或 checkPermission.kt 脚本扫描清单中的权限声明与运行时请求的一致性。

<!-- ExoPlayer 权限清单模板（完整版） -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 本地文件播放（请根据minSdk选择正确权限名） -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<!-- 如需后台播放或通知 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />