IINA播放器中实现自定义时间戳复制功能

背景介绍

IINA作为一款基于mpv的现代化视频播放器，以其优雅的界面和强大的功能受到用户喜爱。在实际使用场景中，视频内容创作者和研究者经常需要记录视频中的特定时间点，用于制作字幕、添加注释或进行视频分析。传统方法需要手动记录时间码，效率较低且容易出错。

技术实现方案

通过IINA的脚本扩展功能，我们可以实现一键复制当前播放时间戳的功能。核心原理是利用mpv的Lua脚本接口获取当前播放位置，并通过系统命令将格式化后的时间字符串复制到剪贴板。

核心脚本解析

以下是实现该功能的核心Lua脚本代码：

-- 全局时间格式变量
local time_format = "[%02d:%02d:%02d]"

-- 时间格式化函数
function format_time(seconds)
    local hours = math.floor(seconds / 3600)
    local minutes = math.floor((seconds % 3600) / 60)
    local secs = math.floor(seconds % 60)
    
    -- 智能时间格式判断
    if hours > 0 then
        return string.format(time_format, hours, minutes, secs)
    else
        return string.format("[%02d:%02d]", minutes, secs)
    end
end

-- 获取当前播放位置
function get_playback_position()
    local position = mp.get_property_number("time-pos")
    return position and format_time(position) or "[--:--:--]"
end

-- 复制到剪贴板功能
function copy_to_clipboard()
    local position = get_playback_position()
    local clipboard_command = "echo '"..position.."' | pbcopy"
    local check_command = "pbpaste"
    
    os.execute(clipboard_command)
    
    -- 验证复制结果
    local handle = io.popen(check_command)
    local clipboard_content = handle:read("*a"):gsub("\n", "")
    handle:close()
    
    -- 显示操作结果
    if clipboard_content == position then
        mp.osd_message("已复制时间戳: "..position, 2)
    else
        mp.osd_message("复制失败", 2)
    end
end

-- 绑定快捷键
mp.add_key_binding("n", "copy_position", copy_to_clipboard)

功能特点

1. 智能时间格式：自动判断视频时长，超过1小时显示[HH:MM:SS]，不足1小时显示[MM:SS]
2. 操作反馈：通过OSD(屏幕显示)消息提示操作结果
3. 可靠性验证：复制后自动验证剪贴板内容确保操作成功
4. 自定义灵活：可轻松修改时间格式或快捷键绑定

安装配置步骤

1. 创建脚本文件：在用户配置目录下新建~/.config/mpv/scripts/copy_playback_position.lua
2. 编辑脚本内容：将上述代码复制到文件中
3. 配置IINA：确保IINA使用正确的mpv配置目录
4. 重启应用：使脚本生效

高级定制建议

1. 多格式支持：可扩展脚本支持多种时间格式切换
2. 上下文菜单：可添加右键菜单项方便鼠标操作
3. 历史记录：实现时间戳历史记录功能
4. 导出功能：支持将多个时间点导出为文本文件

应用场景

1. 视频剪辑：快速标记需要剪辑的时间点
2. 学术研究：记录实验视频中的关键事件时间
3. 字幕制作：准确定位字幕出现和消失的时间
4. 教学视频：为视频内容添加时间标记便于学生复习

通过这个简单而强大的脚本扩展，IINA用户可以显著提升视频标注和记录的工作效率，将注意力集中在内容本身而非繁琐的时间记录上。