OBS Advanced Timer - 高级计时器脚本

obs-advanced-timer 是一个专为 OBS Studio 设计的 Lua 脚本，能够将文本源转换为功能强大的计时器。无论是直播、视频录制还是时间敏感的内容创作，这个脚本都能成为你的得力助手。

功能特点

多种计时模式

• 倒计时模式：从指定的秒数开始倒计时
• 正计时模式：启动秒表式计时器
• 特定时间倒计时：倒计时到特定时间（如倒计时到12:00）
• 特定日期和时间倒计时：倒计时到具体的日期和时间
• 流媒体计时器：流媒体开始时自动启动计时
• 录制计时器：录制开始时自动启动计时

灵活的格式化选项

默认格式为：%0H:%0m:%0s (00:00:00)，支持以下格式化选项：

%d - 天数
%0h - 带前导零的小时（00..23）
%h - 小时（0..23）
%0H - 带前导零的小时（00..无穷大）
%H - 小时（0..无穷大）
%0m - 带前导零的分钟（00..59）
%m - 分钟（0..59）
%0M - 带前导零的分钟（00..无穷大）
%M - 分钟（0..无穷大）
%0s - 带前导零的秒（00..59）
%s - 秒（0..59）
%0S - 带前导零的秒（00..无穷大）
%S - 秒（0..无穷大）
%t - 十分之一秒
%2t - 百分之一秒
%3t - 千分之一秒

激活模式

• 全局模式：计时器始终处于激活状态
• 启动时激活：当源被激活时启动计时器（如切换到包含该源的场景或将源可见性打开时）

热键控制

支持设置启动/停止和重置计时器的快捷键，方便在直播或录播过程中轻松操控计时器。

应用场景

直播应用

在游戏直播中，可以使用倒计时功能来显示比赛开始的剩余时间，或在直播活动中提醒观众即将到来的关键时刻。

视频录制

在教程或教育内容制作中，可以通过倒计时来组织内容结构，确保每个部分都在预定时间内完成。

时间管理

当需要严格控制每一段讲话或表演的时间时，obs-advanced-timer 可以提供即时的时间反馈。

在线课程

教师可以在上课开始或结束时使用计时器提醒学生，还可以用作课间休息的倒计时工具。

技术实现

该脚本基于 Lua 语言开发，充分利用了 OBS Studio 的 API 接口。通过精确的时间计算和文本更新机制，实现了多种计时模式的切换和格式化显示。

核心功能包括：

• 时间差分计算（delta_time 函数）
• 文本格式化处理（set_time_text 函数）
• 事件监听和处理（on_event 函数）
• 定时器控制（start_timer、stop_timer 函数）

安装和使用

1. 克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/ob/obs-advanced-timer

2. 在 OBS Studio 中添加脚本：

   • 打开 OBS Studio
   • 进入"工具"菜单选择"脚本"
   • 点击"+"号添加脚本
   • 选择下载的 advanced-timer.lua 文件

3. 配置计时器：

   • 选择要作为计时器的文本源
   • 设置计时模式和格式化选项
   • 配置激活模式和热键

obs-advanced-timer 是一款高效且易于使用的 OBS Studio 扩展，对于所有寻求时间管理工具的直播者和内容创作者来说，都是不可多得的选择。