mpv-android 配置指南：从默认播放器改造成符合你习惯的样子
项目地址: https://gitcode.com/gh_mirrors/mp/mpv-android mpv-android 是基于 libmpv 的 Android 视频播放器。它的每个开关最终都会翻译成 mpv 的选项参数，配合 mpv.conf 配置文件，几乎每个画面、声音、手势细节都可以改。读完本文，你会完成首次安装的必要设置，拿到观影、通勤、省电三套可直接抄的配置，并学会用配置文件和日志做深度调优。
mpv-android 的手机播放界面，底部控制栏可配置显示
先搞懂：设置是怎么生效的
理解这一层，后面所有操作都不会迷路。mpv-android 的定制分三层：
- 设置界面：主界面点齿轮进入，分 General（常规）、Video（视频）、UI（界面）、Gestures（手势）、Developer（开发者）、Advanced（高级）六页，对应源码里的 app/src/main/res/xml/pref_general.xml、pref_video.xml 等文件。每个开关背后就是一个 mpv 参数，比如硬件解码对应
hwdec，播放时立即生效。 - 配置文件：Advanced 页里可以直接编辑
mpv.conf和input.conf（源码实现见 app/src/main/java/is/xyz/mpv/preferences/ConfigEditDialogPreference.kt），文件存在应用私有目录的files/下，等价于桌面 mpv 的配置文件，可以写任何 mpv 支持的选项。 - 播放器本体：解码、渲染、字幕全部由 libmpv 完成，原生代码在 app/src/main/jni/。
所以最安全的入手方式是：先用设置界面调日常体验，确认满意后再把个性化项沉淀进 mpv.conf。改错了也不怕——设置界面随时能改回来，配置文件删掉那行即可。
第一次安装后值得动的 4 个开关
其余项保持默认即可，以下 4 项对日常观感影响最直接：
- 硬件解码（General → Hardware decoding）：默认已开启，用 MediaCodec 硬解，明显降低发热和耗电。保持开启；只有遇到画面异常时才需要临时关闭。
- 默认音轨 / 字幕语言（General → Default audio/subtitle language）：默认是
eng。看中文内容的多，把字幕语言改成chi，下次打开多语轨视频会自动选中中文字幕，不用每次手动切。 - 后台播放（General → Background play）：默认只在暂停时后台出声（
audio-only）。想锁屏继续看视频选always，只把 mpv 当音乐播放器就维持audio-only。 - 屏幕方向（UI → Auto rotation）：默认
auto跟随传感器。通勤躺床上看建议改成landscape，避免误触旋转导致画面乱跳。
如果手机是 Android 12 及以上，General 里的 Material You theming 可以顺手打开，让界面配色跟随系统主题。
按场景调：观影、通勤、省电各给一套
下面每个场景一段，参数都能直接照抄。涉及缩放的选项在 Video 页，去色带（Debanding）、插帧（Interpolation）、快速解码（Fast decode）也都在这一页。
深夜看电影：画质优先
在 Video 页做三处调整，再在 Advanced 里打开 gpu-next（新版渲染后端）：
- 上采样（Video upscaling）选
ewa_lanczos，下采样（Video downscaling）选spline36或保持默认； - 去色带（Debanding）选
GPU，压缩片的渐变条带会干净很多； - 插帧（Interpolation）按口味选
display-resample，24 帧电影在 60Hz 屏上明显更顺，代价是功耗上升。
老设备如果嫌卡顿，把插帧关掉，打开 Fast decode（跳过部分 B 帧解码），流畅度优先于画质。
通勤路上：省电、单手、防误触
- 插帧和 gpu-next 全关，去色带选
CPU或关闭，把 GPU 压力降到最低； - Gestures 页把左侧竖向手势从默认的 Seek 改成 Brightness、右侧改 Volume，单手握持时大拇指分工更合理；
- 打开 UI 页的 Remember brightness，记住上次的手动亮度；
- 打开 General 的 Save position，地铁挤一下退出应用，回来接着上次位置播。
接电视 / 大屏：字幕放大与方向
大屏上小字幕几乎看不清。打开 Advanced 编辑 mpv.conf，加一行：
# 接大屏时放大 ASS 字幕（数值按屏幕调，2 左右通常合适）
sub-scale=2
同时 UI 页把 Auto rotation 固定为 landscape。如果电视/大屏上遇到画面比例问题，可在 mpv.conf 里用 video-aspect-override 修正，取值以项目实际版本支持的 mpv 文档为准。
长时间挂机：让机器喘口气
组合拳：硬解保持开、插帧关、去色带关、Fast decode 开。网络流卡顿时再往 mpv.conf 加一行：
# 加大 demux 缓存，缓解弱网缓冲
demuxer-max-bytes=200M
平板上的设置界面，双栏布局更适合逐项调参数
进阶玩法（适合进阶）：配置文件、脚本与日志
编辑 mpv.conf 和 input.conf
Advanced 页有两个入口，分别编辑 mpv.conf（选项）和 input.conf（按键绑定）。input.conf 支持键盘输入——接蓝牙键盘或手柄时，把按键映射到 seek、playlist-next 等命令，参照 mpv 官方手册中 input 章节的格式即可（以项目实际版本为准）。
看统计信息
Developer 页的 Stats mode 可以打开原生 FPS 计数器或内置 stats.lua 的三种视图（General / Timings / Cache）。调缓存或怀疑掉帧时，开着它看数字比凭感觉靠谱。
脚本与 Lua
mpv-android 内置了 stats.lua 等脚本。自己写 Lua 脚本时，可参照应用内的脚本机制放置和调用，具体目录与加载方式以项目实际实现为准；app/src/main/jni/main.cpp 能看到初始化时向 libmpv 传了哪些参数，是理解默认行为的好入口。
看日志
通过 ADB 抓 logcat，过滤 mpv 相关 tag：
adb logcat | grep -i mpv
配合 Developer 页的 GPU debug 开关，可以进一步缩小渲染问题的范围。
不同设备形态怎么用
- 手机：默认形态，上面所有场景都适用；注意省电场景的优先级最高。
- 平板：设置界面自动变双栏，逐项调参更舒服；手势区域随屏幕变大，左右分区的音量/亮度误触问题反而更小。
- Android TV：项目支持 TV 端，通过 F-Droid 或手动装 APK 获取；遥控器按键同样走 input.conf 体系，绑定方式与键盘一致（以项目实际版本为准）。
平板上的播放界面，更大的触控区域
三套开箱即用的配置
以下每组都写在 mpv.conf 里，配合设置界面的开关使用。三组互斥，按需求只启用一套。
A. 影院向（好设备、追画质）
hwdec=mediacodec-copy
# gpu-next 在 Advanced 页打开
# 设置界面：插帧 display-resample、去色带 GPU
cache=yes
save-position-on-quit=yes
B. 通勤向（老设备、追省电）
hwdec=mediacodec
# 设置界面：Fast decode 开、插帧关、去色带关
# 网络流弱网时保留下一行
demuxer-max-bytes=200M
C. 追番向（自动选中中文轨）
# 设置界面：字幕语言填 chi
# ASS 字幕在 OLED 屏上避免高亮色烧屏
sub-ass-force-colors=
注：具体选项名和取值以你所装版本的 mpv 手册为准，写错时 mpv 会在日志里警告并忽略该行。
出问题了怎么排查
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 有音无画 / 画面撕裂 | 硬解与特定解码不兼容 | 关掉硬件解码用软解测试；或 Advanced 里切换 gpu-next |
| 高码率视频掉帧 | 解码或缩放开销过大 | 开 Fast decode，关闭插帧，去色带改 CPU |
| 字幕乱码 | 字幕文件编码问题 | 用文本工具把字幕转成 UTF-8 后重开 |
| 音画不同步 | 解码延迟波动 | 检查是否开了 Fast decode；mpv.conf 加 audio-pitch-correction=yes 观察 |
| 锁屏后没声 | 后台播放选了 never | General 里改成 audio-only 或 always |
改了 mpv.conf 没生效 | 选项写错被忽略 | 看 logcat 警告，对照当前版本 mpv 手册修正拼写 |
下一步
- 先按「第一次安装后值得动的 4 个开关」过一遍设置界面，再挑一套配方写进
mpv.conf，坚持用一周再决定是否继续精调。 - 想深入渲染和手势细节，直接读源码：渲染在 app/src/main/jni/render.cpp，手势在 app/src/main/java/is/xyz/mpv/TouchGestures.kt。
- 从源码构建可看 buildscripts/README.md；遇到问题可以去 IRC 的
#mpv-android（irc.libera.chat）问，那里是项目团队日常出没的地方。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
