XPlayer 视频扫描机制与目录管理配置

自动扫描机制

XPlayer 首次启动时会自动扫描以下位置：

• 手机内部存储根目录下的所有视频文件
• 外部 SD 卡（如果存在）中的视频文件
• 默认视频文件夹（Movies、Download、DCIM 等）

扫描逻辑基于 文件扩展名匹配，识别的视频扩展名包括 mp4、mkv、avi、flv、wmv、rmvb、ts、mov、3gp、m4v、webm 等。

扫描结果展示

扫描完成后，首页会以 视频列表 的形式展示所有找到的视频文件，支持以下视图切换：

• 按文件夹分组 —— 同一个文件夹内的视频归为一组
• 按时间排序 —— 最新修改的视频排在最前
• 按名称排序 —— 字母顺序排列
• 网格视图 —— 缩略图网格展示

手动指定扫描目录

如果自动扫描漏掉了某些文件夹（比如自定义命名的下载目录、BT 下载目录等），可以手动添加扫描路径。

操作步骤

1. 打开 XPlayer 设置
2. 进入「视频目录」或「扫描设置」
3. 点击「添加目录」
4. 使用文件选择器找到目标文件夹
5. 确认添加，XPlayer 会立即对该目录执行扫描

排除文件夹

如果不希望某些目录（如游戏缓存、应用临时文件等）出现在扫描结果中，可以设置排除规则：

1. 设置 → 视频目录
2. 找到要排除的文件夹
3. 长按或点击右上角菜单
4. 选择「排除此文件夹」

排除后该文件夹不会被扫描，其内的视频文件也不会出现在首页列表中。

刷新扫描

以下情况需要手动刷新扫描：

• 刚下载了新视频
• 从其他 App 录制了新视频
• 手动移动或重命名了视频文件
• 修改了扫描目录设置

刷新方法

方法一：设置中刷新

1. 设置 → 扫描设置
2. 点击「重新扫描全部」
3. 等待扫描完成

方法二：首页快捷刷新

• 部分版本在首页顶部提供刷新按钮（圆形箭头图标），点击即可触发扫描

SD 卡兼容性

注意事项

• 部分 Android 6.0+ 设备对外部 SD 卡的写入权限有限制，XPlayer 可能只能读取但无法写入 SD 卡
• 如果视频在 SD 卡上无法播放，将文件移动到内部存储通常可以解决
• 加密 SD 卡（设备加密格式）XPlayer 无法扫描

扫描性能优化建议

• 视频文件总量较大（数千个）时，首次扫描可能需要数分钟
• 建议定期执行扫描（可在设置中开启定时扫描）
• 排除不需要的文件夹可以显著减少扫描时间
• 如果长期扫描时间过长，考虑检查是否有损坏的视频文件导致扫描异常