屏幕控制器

本节介绍 mpv 的 OSC（On Screen Controller）配置和自定义。

OSC 基本配置

启用 OSC

# 启用 OSC
osc=yes

# 禁用 OSC
osc=no

OSC 样式

# OSC 布局
script-opts=osc-layout=bottombar
script-opts=osc-layout=topbar
script-opts=osc-layout=box
script-opts=osc-layout=slimbox

OSC 选项

OSC 行为

# 死区大小
script-opts=osc-deadzonesize=0

# 最小鼠标移动
script-opts=osc-minmousemove=3

# 自动隐藏
script-opts=osc-hidetimeout=500

OSC 显示

# OSC 字体
script-opts=osd-font="Noto Sans CJK SC"

# OSC 字体大小
script-opts=osd-font-size=20

# OSC 颜色
script-opts=osd-color="#FFFFFFFF"

OSC 功能

播放控制

# 播放/暂停按钮
# 进度条
# 音量滑块
# 全屏按钮
# 播放列表按钮

信息显示

# 媒体标题
# 播放时间
# 音量信息
# 字幕信息

OSC 自定义

自定义 OSC

-- 自定义 OSC 脚本
local mp = require 'mp'

-- 自定义 OSC 布局
mp.add_key_binding('ctrl+o', 'custom-osc', function()
    -- 自定义 OSC 逻辑
end)

OSC 脚本

// 自定义 OSC 脚本
mp.add_key_binding('ctrl+o', 'custom-osc', function() {
    // 自定义 OSC 逻辑
});

OSC 调试

调试信息

# 显示 OSC 信息
mpv --msg-level=all=v video.mp4

# 测试 OSC
mpv --script-opts=osc-debug=yes video.mp4

OSC 测试

# 测试 OSC 布局
mpv --script-opts=osc-layout=bottombar video.mp4

# 测试 OSC 样式
mpv --script-opts=osd-font-size=20 video.mp4

OSC 故障排除

常见问题

1. OSC 不显示

   • 确保启用 OSC：osc=yes
   • 检查 OSC 配置

2. OSC 样式异常

   • 检查 OSC 字体配置
   • 检查 OSC 颜色配置

3. OSC 响应慢

   • 调整死区大小：script-opts=osc-deadzonesize=0
   • 调整鼠标移动：script-opts=osc-minmousemove=3

调试命令

# 显示 OSC 信息
mpv --msg-level=all=v video.mp4

# 测试 OSC
mpv --script-opts=osc-debug=yes video.mp4

下一步

• 统计信息 - 播放统计和性能监控
• 控制台 - 控制台命令和调试
• 上下文菜单 - 右键菜单配置