OPlayer 自动扫描视频文件原理与排除过滤规则

扫描逻辑

OPlayer 在首次启动和每次进入「视频」标签页时，都会扫描手机存储中所有常见视频格式的文件：

• 扫描范围：手机内部存储（/storage/emulated/0/）和已挂载的 SD 卡
• 识别方式：按文件扩展名识别，如 .mp4、.mkv、.avi 等
• 自动更新：新增加的视频在下次打开时自动出现在列表中

扫描完成后会生成一个列表缓存，后续进入页面时从缓存读取，速度很快。

为什么有些视频没显示

一、文件扩展名不在支持列表

有些下载工具会把视频扩展名改掉（比如把 .mkv 改成 .bin 来避开某些平台的检测）。这种文件 OPlayer 不会扫到。

解决方法：用文件管理器手动把扩展名改回正确的视频格式，然后重启 OPlayer 刷新。

二、文件在隐藏目录

以点号（.）开头的目录在 Android 中属于隐藏目录，OPlayer 默认不扫描这些目录。常见的隐藏目录包括：

• .android_secure/
• .trash/
• 某些应用的私有缓存目录

如果视频在这些目录下，需要将它们移动到普通目录。

三、权限不足

在 Android 11 及以上版本，分区存储机制限制了应用对其他应用目录的访问。如果视频是通过微信、QQ、抖音等应用下载的，可能存放在这些应用的私有目录中，OPlayer 无法扫描。

解决方法：在微信/QQ 的设置中更改文件下载路径到公开目录（如 Download 或 Movies），然后重启 OPlayer。

四、扫描排除规则

部分目录会被 OPlayer 自动排除，避免把系统自带的短视频、游戏 CG 等无关内容混进列表。你可以在设置中查看或修改排除规则。

手动刷新扫描

如果确定新视频应该被扫到但没出现，试试以下方法：

1. 下拉视频列表强制刷新
2. 进入设置 → 清除缓存 → 重新扫描
3. 完全关闭 OPlayer 后重新打开

手动浏览目录

如果你知道视频在哪个文件夹，但 OPlayer 的自动列表里找不到，可以切换到手动浏览模式：

1. 在视频标签页点击右上角的文件夹图标
2. 逐级进入目标目录
3. 直接点击目录中的视频文件播放