告别手动记录：MPV播放器实现播放进度自动保存的完整方案

你是否曾遇到这样的困扰：观看一部长篇电影中途被打断，下次打开时却要从头开始寻找上次的观看位置？MPV播放器（Command line video player）提供了完善的播放进度保存功能，让你轻松实现断点续播。本文将详细介绍如何配置和使用这一功能，以及背后的技术实现原理。

核心功能解析

MPV通过--save-position-on-quit选项和write-watch-later-config命令实现播放进度保存。当启用该功能时，MPV会在退出时自动将当前播放位置、音量、窗口大小等状态信息保存到文件中，下次播放同一文件时自动恢复。

保存位置原理

MPV使用特殊的状态文件存储播放进度，这些文件默认保存在：

• Linux/BSD系统：$XDG_STATE_HOME/mpv/watch_later（通常是~/.local/state/mpv/watch_later）
• Windows系统：%LOCALAPPDATA%\mpv\watch_later

状态文件命名基于文件路径的哈希值，确保每个文件有唯一的进度记录。

基础配置方法

临时启用（命令行方式）

最简单的方法是在启动MPV时添加--save-position-on-quit参数：

mpv --save-position-on-quit video.mp4

退出时按Q键（注意是大写Q）而非普通的q键，MPV会显示"Saving state..."提示并保存进度。

永久启用（配置文件方式）

1. 编辑MPV配置文件mpv.conf，该文件通常位于：

   • Linux：~/.config/mpv/mpv.conf
   • Windows：%APPDATA%\mpv\mpv.conf

2. 添加以下内容：

# 启用退出时保存进度
save-position-on-quit=yes

# 可选：自动恢复播放进度
resume-playback=yes

# 可选：检查文件修改时间（防止文件更新后使用旧进度）
resume-playback-check-mtime=yes

配置文件模板可参考系统默认配置etc/mpv.conf。

高级用法与技巧

手动控制保存时机

除了自动保存，MPV还提供手动控制命令：

• write-watch-later-config：立即保存当前进度（默认绑定到Shift+q）
• delete-watch-later-config：删除当前文件的进度记录

这些命令在需要精确定位或放弃保存时非常有用。

自定义保存内容

通过--watch-later-options可以指定要保存的状态项，默认包括：

start,volume,ao-volume,mute,window-scale,sub-delay,audio-delay,video-delay,sub-visibility,secondary-sub-visibility

如需添加或移除项目，可在配置文件中设置：

# 仅保存播放位置和音量
watch-later-options=start,volume

完整选项说明参见DOCS/man/options.rst。

图形界面指示

MPV的OSD（屏幕显示）会在进度保存和恢复时显示提示信息：

• 保存时：显示"Saving state..."
• 恢复时：显示"Resuming from X:XX:XX"

注意事项与故障排除

常见问题解决

1. 进度不保存：

   • 确保使用Q键退出而非q键
   • 检查是否有写入权限：~/.local/state/mpv/watch_later目录
   • 确认配置文件中没有resume-playback=no（默认配置etc/builtin.conf中可能设置了此值）

2. 错误恢复旧进度：

   • 启用resume-playback-check-mtime=yes检查文件修改时间
   • 手动删除对应状态文件：rm ~/.local/state/mpv/watch_later/*

3. 某些文件不保存进度：

   • 直播流和某些网络协议不支持进度保存
   • 可通过--no-save-position-on-quit为特定文件禁用保存

实现原理与源码解析

状态保存流程

1. 用户按下Q键触发退出
2. player/command.c中的cmd_write_watch_later_config函数被调用
3. player/core.h中定义的状态结构被序列化
4. player/command.c中的write_watch_later_config函数将状态写入文件系统

关键代码位置

• 命令处理：player/command.c
• 状态管理：player/core.h
• 配置选项定义：DOCS/man/options.rst
• 默认配置：etc/builtin.conf

总结与最佳实践

推荐配置组合：

# 基础设置
save-position-on-quit=yes
resume-playback=yes
resume-playback-check-mtime=yes

# 增强体验
keepaspect-window=yes
save-position-on-pause=no  # 避免暂停时误保存

MPV的播放进度保存功能轻量而强大，通过简单配置即可显著提升观影体验。无论是日常追剧还是学习视频课程，这一功能都能帮你无缝衔接每次观看。更多高级用法可参考官方文档DOCS/man/mpv.rst。

记住：按Q键退出保存进度，按q键退出不保存进度，这是使用该功能的关键区别。