控制台

本节介绍 mpv 的控制台命令和调试。

控制台命令

打开控制台

# 打开控制台
script-message console

# 控制台快捷键
` script-message console

控制台命令

# 设置属性
set volume 80

# 获取属性
get volume

# 执行命令
seek 10
cycle pause

控制台配置

控制台样式

# 控制台字体
script-opts=console-font="Noto Sans CJK SC"

# 控制台字体大小
script-ops=console-font-size=20

# 控制台颜色
script-opts=console-color="#FFFFFFFF"

控制台行为

# 控制台历史
script-opts=console-history=100

# 控制台自动完成
script-opts=console-autocomplete=yes

控制台功能

命令执行

# 执行命令
set volume 80
seek 10
cycle pause

# 获取属性
get volume
get time-pos
get media-title

属性查看

# 查看属性
get volume
get time-pos
get media-title

# 查看所有属性
list-properties

控制台调试

调试信息

# 显示控制台信息
mpv --msg-level=all=v video.mp4

# 测试控制台
mpv --script-opts=console-debug=yes video.mp4

控制台测试

# 测试控制台命令
set volume 80
seek 10
cycle pause

# 测试属性查看
get volume
get time-pos

控制台脚本

Lua 脚本控制台

-- 控制台脚本
local mp = require 'mp'

mp.add_key_binding('ctrl+`', 'toggle-console', function()
    mp.command('script-message console')
end)

JavaScript 脚本控制台

// 控制台脚本
mp.add_key_binding('ctrl+`', 'toggle-console', function() {
    mp.command('script-message console');
});

控制台故障排除

常见问题

1. 控制台不打开

   • 确保启用控制台：script-message console
   • 检查脚本配置

2. 控制台命令不执行

   • 检查命令语法
   • 检查属性名称

3. 控制台样式异常

   • 检查控制台字体配置
   • 检查控制台颜色配置

调试命令

# 显示控制台信息
mpv --msg-level=all=v video.mp4

# 测试控制台
mpv --script-opts=console-debug=yes video.mp4

下一步

• 上下文菜单 - 右键菜单配置
• 窗口定位 - 窗口位置和大小控制
• 命令接口 - 命令系统详解