我用实际体验说话——蘑菇视频 iOS 播放进度的“优先级规则”，搞懂就不乱了
作为一个长期折腾视频 App 的用户，我把在 iPhone 上反复试验、出错和修复的结论整理成这篇经验贴。蘑菇视频在播放进度上看似简单，实则有一套隐含的“优先级规则”。弄清这些规则，能避免进度被错乱、断点跳跃或被覆盖的尴尬场景。
核心结论（一句话）
- 本地记录优先于云端；最近更新时间优先于旧记录；手动标记/下载记录常常独立于在线历史。按这三条去判断，就能解释大多数异常。
优先级规则分解（基于实际操作观察）
- 本地进度 > 云端进度
- 在当前设备有本地播放痕迹（包括未上传的缓存或下载播放记录）时，播放器通常优先从本地恢复到最后播放位置。也就是说，即便云端显示的是别处的进度，只要本地有痕迹，就会先用本地数据。
- 最近时间戳覆盖旧记录
- 当多个设备或多次播放产生冲突时，系统倾向于把“最后一次停止播放”的时间较新的记录作为最终位置。多个设备同时播放同一集时，谁最后停止就以谁为准。
- 下载/离线进度常常独立
- 离线下载的视频在本地播放时，会保存本地进度，这个进度不一定会实时同步到云端。回到在线播放时，可能出现进度未合并的情况。
- 手动操作（标记已看/设为未看）优先级高
- 用户手动设置“已看/未看”或用进度条拖到某处并确认，这类动作往往能覆盖其他自动记录。
- 单集 vs 剧集逻辑
- 进度记录通常以“单集”为最小单位；整季续看会依据每集的已看比例做跳转判断（例如超过某一百分比会被判定为“已看”并跳到下一集）。
实用操作步骤（避免进度混乱的做法）
- 统一登录同一账号
- 在多设备上使用同一账号并开启历史/同步功能，能最大程度减少冲突。
- 切换设备前让 App 完成上传
- 在结束观看后等几秒再换设备或关闭 App，给同步留出时间。在线条件下，这能防止旧进度覆盖新进度。
- 下载观看需谨慎
- 若用离线下载，在回到在线观看前请确认是否需要合并进度；必要时手动在播放页设置正确位置或在历史中修改。
- 发现异常先别慌，按顺序排查
- 检查网络和登录状态 → 进入播放页查看显示的时间戳/历史 → 清缓存或重新登录 → 若仍异常，使用“设为已看/未看”修正。
常见问题与快速修复
- 进度没同步：确认登录账号、网络、允许后台刷新和蜂窝数据，或在设置里手动触发同步/刷新历史。
- 进度被覆盖成旧位置：在设备上检查本地历史，若本地有正确记录，尝试在本地播放到该点并暂停，等待上传覆盖云端旧记录。
- 同一集在不同清晰度下进度不一致：切换清晰度可能会重置或分开保存进度，建议固定一种播放源或手动合并位置。
- 离线播放的进度没上传：检查存储权限与剩余空间，必要时在线播放短时间让 App 上传进度。
实战小场景（帮助你快速判断）
- 场景 A：在 iPhone 看到第 8 分钟，切到 iPad 却回到第 2 分钟——可能是 iPhone 的本地进度未及时上传，iPad 使用的是云端的旧时间戳。让 iPhone 在第 8 分钟停几秒再切换即可。
- 场景 B：下载到手机看完并标为已看，但云端仍显示未看——离线进度未同步，回到网络环境，打开在线播放页让 App 上传或手动在历史中标记。
结语 把“本地优先、最新时间覆盖、离线独立”这三条放在脑子里，遇到进度错乱的大多数情况都能迎刃而解。遇到特别顽固的异常，先按排查步骤操作，再联系官方客服并提供设备型号、App 版本和发生时间，定位会更快。
