首次启动权限授予与安全配置
首次启动流程概览
安装完成后第一次打开 XPlayer，会依次触发以下流程：
- 欢迎界面 —— 应用启动动画
- 权限请求 —— 依次请求必要的系统权限
- 视频扫描 —— 自动扫描设备中的视频文件
- 主界面 —— 扫描完成后进入首页视频库
权限清单与用途说明
XPlayer 在首次启动时会请求以下权限。理解每个权限的用途，有助于做出合理的授权决策。
必需权限（拒绝后核心功能不可用）
| 权限 | 用途 | 拒绝的后果 |
|---|---|---|
| 读取外部存储 | 扫描并播放手机 / SD 卡中的视频文件 | 看不到本地视频，无法播放 |
| 写入外部存储 | 保存截图、私密文件夹加密文件、下载的视频 | 无法截屏、无法使用下载功能 |
| 网络访问 | AI 字幕在线识别、在线字幕下载、Chromecast 投屏、应用更新 | AI 字幕不可用、无法下载字幕、无法投屏 |
可选权限（拒绝不影响核心播放）
| 权限 | 用途 | 拒绝的后果 |
|---|---|---|
| 通知权限 | 后台下载进度通知、投屏连接提示、睡眠定时到期提醒 | 无法接收上述通知，但功能本身仍正常工作 |
| 悬浮窗权限 | 悬浮窗模式播放视频 | 悬浮窗不可用，其他播放方式正常 |
| 精确闹钟权限 | 睡眠定时功能的精确计时 | 睡眠定时可能有延迟 |
Android 13+ 特殊注意
Android 13 及以上版本对存储权限做了细分：
- READ_MEDIA_VIDEO —— 读取视频文件（替代旧版的 READ_EXTERNAL_STORAGE）
- READ_MEDIA_AUDIO —— 读取音频文件
- READ_MEDIA_IMAGES —— 读取图片（用于封面显示）
XPlayer 会分别请求这三个细粒度权限。全部授予后才能完整扫描所有媒体文件。
安全配置建议
最小权限集原则
如果隐私敏感度较高，可以选择性授予权限：
- 只播放本地视频：授予存储权限即可，拒绝网络权限（AI 字幕和在线下载不可用）
- 只用本地字幕：网络权限可按需授予
- 拒绝通知权限：不影响播放，只是收不到提醒
私密文件夹首次设置
完成权限授予后，建议 立即 设置私密文件夹密码：
- 进入设置 → 私密文件夹
- 设定密码（4–16 位数字）
- 绑定邮箱或设置安全问题（用于密码找回）
这样下次打开私密文件夹才需要密码验证。如果没设置密码，私密文件夹功能形同虚设。
应用锁设置
如果担心整个应用被他人打开，可以额外开启应用锁：
- 设置 → 安全 → 应用锁
- 选择锁屏方式（密码 / 图案 / 指纹）
- 设置锁定间隔（立即 / 退出后 1 分钟 / 退出后 5 分钟）
常见权限问题排查
视频扫描不到文件
- 确认已授予存储权限
- 检查 Android 13+ 是否同时授予 READ_MEDIA_VIDEO
- 部分厂商（小米、华为、OPPO）有额外的存储权限开关，需在系统设置中单独开启
Chromecast 搜索不到设备
- 确认网络权限已授予
- 手机和 Chromecast 必须在同一局域网
- 检查是否被系统省电策略限制后台网络访问
AI 字幕按钮点击无反应
- 确认网络权限已授予
- AI 字幕需要向云端发送视频片段进行识别，必须联网
- 网络环境不稳定时可能超时，建议 WiFi 环境下使用