mpv 播放器

主题

视频驱动 ​

本节列出 mpv 的视频输出驱动。

自动选择 ​

自动驱动 ​

bash
# 自动选择最佳驱动
vo=auto

GPU 输出 ​

GPU 驱动 ​

bash
# GPU 输出（推荐）
vo=gpu

特性：

  • 支持硬件加速
  • 高质量渲染
  • 支持多种后端

支持的后端：

  • Windows: Direct3D 11、OpenGL
  • macOS: Metal、OpenGL
  • Linux: Vulkan、OpenGL

配置示例：

bash
# 使用 GPU 输出
vo=gpu

# 指定后端
gpu-api=vulkan
gpu-api=opengl
gpu-api=d3d11

# 高质量配置
profile=gpu-hq

GPU-Next 输出 ​

bash
# GPU-Next 输出
vo=gpu-next

特性：

  • 新一代 GPU 输出驱动
  • 更好的色彩管理
  • 更高效的渲染管线

空输出 ​

空驱动 ​

bash
# 空输出（仅音频）
vo=null

特性：

  • 不显示视频
  • 仅用于测试或音频提取

驱动选项 ​

GPU 选项 ​

bash
# GPU API
gpu-api=vulkan
gpu-api=opengl
gpu-api=d3d11

# GPU 渲染配置
profile=gpu-hq
profile=gpu
profile=fast

窗口选项 ​

bash
# 窗口大小
geometry=1280x720

# 窗口位置
geometry=100:100

# 全屏
fullscreen=yes

硬件解码 ​

硬件解码器 ​

bash
# 自动选择硬件解码器
hwdec=auto

# 安全模式
hwdec=auto-safe

# 强制硬件解码
hwdec=auto-copy

特定硬件解码器 ​

bash
# NVIDIA
hwdec=nvdec
hwdec=nvdec-copy

# Intel (Linux)
hwdec=vaapi
hwdec=vaapi-copy

# AMD (Linux)
hwdec=vaapi
hwdec=vaapi-copy

# macOS
hwdec=videotoolbox
hwdec=videotoolbox-copy

# Windows
hwdec=d3d11va
hwdec=d3d11va-copy
hwdec=dxva2
hwdec=dxva2-copy

驱动调试 ​

调试信息 ​

bash
# 显示视频驱动信息
mpv --msg-level=all=v video.mp4

# 测试视频驱动
mpv --vo=gpu video.mp4

驱动测试 ​

bash
# 测试 GPU 输出
mpv --vo=gpu video.mp4

# 测试 GPU-Next
mpv --vo=gpu-next video.mp4

驱动故障排除 ​

常见问题 ​

  1. 视频不显示

    • 检查视频驱动：mpv --vo=auto video.mp4
    • 尝试其他驱动：mpv --vo=gpu video.mp4

  2. 视频卡顿

    • 启用硬件解码：hwdec=auto
    • 降低渲染质量：profile=fast

  3. 色彩异常

    • 检查色彩管理：icc-profile-auto=yes
    • 尝试其他驱动

调试命令 ​

bash
# 显示视频驱动信息
mpv --msg-level=all=v video.mp4

# 测试视频驱动
mpv --vo=gpu video.mp4

下一步 ​