MPV播放器OSC(屏幕控制器)使用指南

MPV播放器OSC(屏幕控制器)使用指南

mpv 🎥 Command line video player 项目地址: https://gitcode.com/gh_mirrors/mp/mpv

什么是OSC

OSC(On Screen Controller)是MPV播放器内置的一个简约图形界面，它为用户提供了基本的鼠标控制功能。这个界面设计初衷是让新用户更容易上手，同时支持精确的进度定位操作。

基本使用

OSC默认在MPV编译时如果启用了Lua支持就会自动开启。用户可以通过--osc=no参数完全禁用它。

当鼠标在播放器窗口内移动时，OSC会自动显示；如果鼠标停止移动超过0.5秒或移出窗口，OSC会自动隐藏。

界面布局解析

OSC界面采用分层设计，主要分为三个部分：

1. 顶部控制栏：

   • 菜单按钮
   • 播放列表导航(上一个/下一个)
   • 媒体标题显示区域
   • 缓存状态指示器

2. 主控制区：

   • 播放/暂停按钮
   • 章节跳转(向前/向后)
   • 已播放时间显示
   • 进度条
   • 剩余时间显示

3. 功能按钮区：

   • 音轨切换
   • 字幕切换
   • 音量控制
   • 全屏切换

详细功能说明

1. 菜单按钮

• 左键点击：打开主菜单
• 中键/Shift+左键：无默认功能(可配置)
• 右键：无默认功能(可配置)

2. 播放列表导航

• 左键：跳转至上一个/下一个播放项
• 中键/Shift+左键：显示播放列表
• 右键：打开播放列表菜单

3. 标题区域

• 显示当前播放项在列表中的位置和媒体标题
• 左键：显示文件和轨道信息
• 中键/Shift+左键：显示文件路径
• 右键：打开历史记录菜单

4. 播放控制

• 左键：切换播放/暂停状态
• 中键/Shift+左键：切换播放列表循环模式
• 右键：切换当前文件循环模式

5. 章节跳转

• 左键：跳转到章节开始/上一章节/下一章节
• 中键/Shift+左键：显示章节列表
• 右键：打开章节菜单

6. 进度条

• 显示当前播放位置和章节标记
• 左键：跳转到指定位置
• 右键：跳转到最近的章节
• 鼠标滚轮：向前/向后跳转

7. 音轨/字幕控制

• 左键：向前循环切换音轨/字幕
• 中键/Shift+左键：向后循环切换音轨/字幕
• 右键：打开音轨/字幕菜单
• 鼠标滚轮：向前/向后切换音轨/字幕

8. 音量控制

• 左键：切换静音
• 右键：打开音频设备菜单
• 鼠标滚轮：增大/减小音量

9. 全屏控制

• 左键：切换全屏模式
• 右键：切换窗口最大化状态

键盘快捷键

默认情况下，以下快捷键可用(如果未被其他功能占用)：

• Del键：循环切换OSC显示模式(从不显示/鼠标移动时显示/始终显示)

高级配置

OSC可以通过配置文件script-opts/osc.conf进行深度定制，也可以通过--script-opts命令行参数进行设置。

主要配置选项

1. 布局选项：

   • layout：设置OSC布局样式(默认为bottombar)
   • seekbarstyle：进度条样式(bar/diamond/knob)
   • seekbarhandlesize：进度条手柄大小比例

2. 显示控制：

   • showwindowed：窗口模式下是否显示OSC
   • showfullscreen：全屏模式下是否显示OSC
   • idlescreen：空闲时是否显示MPV标志
   • visibility：控制OSC显示模式(auto/never/always)

3. 视觉样式：

   • boxalpha：背景透明度(0-255)
   • fadeduration：淡入淡出效果时长(毫秒)
   • title：自定义标题显示格式

4. 时间显示：

   • timetotal：显示总时间而非剩余时间
   • timems：显示毫秒级时间码
   • unicodeminus：使用Unicode减号显示剩余时间

5. 颜色配置：

   • 可自定义背景、时间码、标题、按钮等各种元素的颜色

实用技巧

1. 精确跳转：使用进度条右键点击可直接跳转到最近的章节点

2. 快速查看信息：

   • 标题区域左键点击可查看详细媒体信息
   • Shift+左键或中键点击播放列表按钮可快速查看播放列表

3. 循环模式切换：

   • 播放按钮的中键和右键可分别控制播放列表循环和单文件循环

4. 章节导航：

   • 章节跳转按钮的中键或Shift+左键可显示章节列表
   • 右键可打开章节菜单进行更详细的选择

5. 自定义配置：

   • 通过修改osc.conf文件可以完全自定义OSC的外观和行为
   • 可以为各种鼠标动作绑定不同的命令

注意事项

1. 某些高级功能(如boxvideo选项)需要将visibility设置为always才能生效

2. 在极低性能设备上，可以考虑关闭livemarkers选项以减少性能开销

3. 窗口控制功能在不支持窗口装饰的平台上特别有用

4. 进度条的精确跳转模式(seekbarkeyframes)可以根据需要开启或关闭

通过合理配置OSC，用户可以打造出既美观又实用的播放控制界面，大幅提升MPV的使用体验。

mpv 🎥 Command line video player 项目地址: https://gitcode.com/gh_mirrors/mp/mpv