mpv 脚本编程指南341

mpv 是一个免费且开源的媒体播放器，它具有强大的脚本编程功能。脚本可以用来定制播放器的外观、行为和功能，从而创建满足特定需求的个性化体验。

脚本语言

mpv 脚本使用 Lua 语言编写。Lua 是一种轻量级、快速且易于学习的脚本语言，非常适合用于编写 mpv 脚本。

脚本类型

有两种主要的 mpv 脚本类型：动作和事件处理程序。
动作是用户可以随时调用的命令，它们通常用于执行一次性任务，例如调整音量或切换字幕。
事件处理程序是对播放器中特定事件的响应，例如视频加载或按键按下。它们可以用来动态地修改播放器的行为。

脚本文件

mpv 脚本存储在文本文件中，其扩展名为 .lua。脚本文件可以放置在以下位置：
~/.config/mpv/scripts/：用户脚本文件夹
/usr/share/mpv/scripts/：系统脚本文件夹

mpv 将按顺序加载这两个文件夹中的所有脚本文件。

编写脚本

要编写一个 mpv 脚本，你需要了解以下基本语法：
注释：以双破折号 (--) 开头，直到行尾
变量：使用 = 赋值，例如：my_variable = 10
函数：使用 function 关键字定义，例如：function my_function() end
条件语句：使用 if、elseif 和 else 关键字，例如：if my_variable == 10 then end
循环：使用 for 和 while 关键字，例如：for i = 1, 10 do end

有关 Lua 语法的更多信息，请参考官方手册。

事件处理

事件处理是 mpv 脚本中最强大的功能之一。它允许你监视播放器中的事件并采取相应的行动。以下是一些常见的事件：
load-file：视频加载时触发
keydown：按键按下时触发
seek：视频位置更改时触发
end-file：视频播放结束时触发

要注册事件处理程序，请使用 mp.add_event_callback() 函数，如下所示：mp.add_event_callback("load-file", function()
-- 处理视频加载事件
end)

事件处理程序函数接受一个事件表作为其唯一参数，该表包含有关事件的各种信息，例如触发事件的按键或视频的新位置。

动作

动作是可以在任何时候调用的一次性命令。以下是一些常见的动作：
set：设置播放器选项，例如：set volume 10
pause：暂停视频播放
seek：将视频位置更改为特定时间
cycle：循环播放模式，例如：cycle fullscreen

要调用动作，请使用 () 函数，如下所示：("set volume 10")

示例脚本

以下是一个简单的脚本示例，它在视频加载时显示一条消息：-- 在视频加载时触发
mp.add_event_callback("load-file", function()
-- 显示一条消息
("视频加载完成")
end)

这个脚本可以保存到 ~/.config/mpv/scripts/，mpv 将在每次加载视频时自动运行它。

高级技巧

除了基本脚本外，mpv 脚本还可以使用以下高级技巧：
全局变量：使用表存储全局变量，它们可以在所有脚本中访问
自定义 CSS：使用 .load_css() 函数加载自定义 CSS 样式表，以修改播放器的外观
创建图形用户界面 (GUI)：使用模块创建自定义 GUI 元素，例如按钮和菜单

资源* [mpv 手册](/manual/master/)
* [mpv 脚本参考](/manual/master/scripting/)
* [mpv 社区论坛](/)

mpv 脚本编程提供了强大的工具来定制和增强媒体播放体验。通过了解 Lua 语言和 mpv 的事件系统，你可以创建自己的脚本，使 mpv 适应你的特定需求。从简单的动作到高级 GUI，mpv 脚本编程的可能性仅受你的想象力限制。

2024-12-05

上一篇：脚本 TCL 编程概述

下一篇：广播脚本编程：赋能电台的艺术