帮助文档

DMX TimeCode Player 完整用户手册

📖 目录

🚀 快速入门

DMX TimeCode Player 是专为灯光设计师设计的专业媒体播放器。它在播放音频或视频文件时通过 Art-Net 广播 SMPTE 时间码,实现与灯光控制台的帧级同步。

快速上手

  1. 下载并安装 DMX TimeCode Player
  2. 启动应用程序
  3. 将媒体文件拖放到播放列表中
  4. 配置 Art-Net 设置 (Universe, Subnet, Net)
  5. 点击播放 —— 时间码将自动广播

💡 提示: 确保您的灯光控制台和 DMX TimeCode Player 在同一网络中以接收时间码。

💻 系统要求

📦 安装指南

  1. 从官网下载 DMG 文件
  2. 打开 DMG 文件
  3. 将 "DMX TimeCode Player" 拖入应用程序文件夹
  4. 首次启动时,右键点击应用并选择"打开" (未签名应用需要此操作)
  5. 如果提示,前往系统偏好设置 → 安全性与隐私,点击"仍要打开"

⚠️ 重要: 应用未进行公证 (Notarized)。macOS 可能会在首次启动时显示警告。这是独立软件的正常现象。

🖥️ 用户界面

主窗口分为几个区域:

播放控制

时间码显示

HH:MM:SS:FF 格式显示当前位置。帧率可在设置中设为 24, 25 或 30 fps。

播放列表

⏱️ Art-Net 时间码

应用程序通过 Art-Net 协议广播 SMPTE 时间码。这允许您的灯光控制台在播放期间的精确时刻触发 Cue。

配置

控制台设置

在您的灯光控制台上:

  1. 启用 Art-Net Timecode 输入
  2. 设置与播放器相同的帧率
  3. 为您的 Cue 创建时间码触发器

💡 支持的控制台: grandMA, Onyx, Hog, Chamsys, ETC Eos 以及任何支持 Art-Net Timecode 的控制台。

🎛️ DMX 控制

使用 Art-Net 或 sACN DMX 输入从灯光控制台控制播放器。

DMX 模式

协议设置

📋 DMX 通道映射

本节提供所有三种操作模式的详细 DMX 通道信息。请选择最适合您需求的模式。

📥 下载适用于您灯光控制台的灯库文件:

兼容 Obsidian Onyx 以及其他支持 .Fixture 文件的控制台。

🟢 标准模式 (1 通道)

基础播放控制与曲目选择。使用单个 DMX 通道控制播放并在曲目间切换。

通道 功能 数值范围 描述
1 播放控制 0–255 0–5: 停止 (重置到开头)
6–10: 暂停 (保持当前位置)
11–20: 播放曲目 1
21–30: 播放曲目 2
31–40: 播放曲目 3
...以 10 为增量递增...
231–240: 播放曲目 23
241–245: 播放曲目 24
246–255: 停止

💡 曲目公式: 曲目号 = floor((DMX 值 - 11) / 10) + 1。例如: DMX 25 播放曲目 2。

🟡 循环模式 (2 通道)

增加循环计数器控制。设置曲目在停止前应重复多少次。

通道 功能 数值范围 描述
1 播放控制 0–255 0–5: 停止
6–10: 暂停
11–245: 播放曲目 N (每 10 个数值 = 下一曲)
246–255: 停止
2 循环计数 0–255 0–9: 使用程序设置 (无 DMX 覆盖)
10–19: 播放 1次
20–29: 播放 2次
30–39: 播放 3次
...以 10 为增量递增...
100–109: 播放 10次
110–255: 无限循环

💡 循环公式: 重复次数 = floor((DMX 值 - 10) / 10) + 1。例如: DMX 45 播放 4 次。

🔴 扩展模式 (18 通道)

对所有播放器功能的完全控制,包括视觉图案和视频效果。所有效果通道使用区域: 0-4 = 无覆盖, 5-9 = 重置为默认, 10-255 = 主动控制。

通道 功能 数值 描述
1 播放控制 0–255 0–5: 停止, 6–10: 暂停
11–245: 播放曲目 N, 246–255: 停止
2 循环计数 0–255 0–9: 使用程序, 10–109: 1次–10次, 110–255: 无限
3 视觉图案 0–255 5–9: 黑色 (默认), 10–255: 选择图案 (每 25 = 下一个图案)
4 图案速度 0–255 5–9: 1倍 (默认), 10–255: 0.1倍 到 3.0倍 动画速度
5 亮度 0–255 5–9: 正常 (0), 10: -100%, 128: 0%, 255: +100%
6 饱和度 0–255 5–9: 100% (默认), 10: 0% (黑白), 255: 200%
7 Alpha (透明度) 0–255 5–9: 100% (默认), 10: 0% (透明), 255: 100%
8 播放速度 0–255 5–9: 1倍 (默认), 10: 0.5倍, 255: 2倍速度
9 RGB 开/关 0–255 5–9: 全开, 10+: 位标志 (R=1, G=2, B=4), 17+ = 全开
10 红色时间偏移 0–255 5–9: 0 帧, 10–255: 0–25 帧延迟
11 绿色时间偏移 0–255 5–9: 0 帧, 10–255: 0–25 帧延迟
12 蓝色时间偏移 0–255 5–9: 0 帧, 10–255: 0–25 帧延迟
13 红色水平偏移 0–255 5–9: 居中, 10: -50px, 132: 0, 255: +50px
14 红色垂直偏移 0–255 5–9: 居中, 10–255: -50px 到 +50px
15 绿色水平偏移 0–255 5–9: 居中, 10–255: -50px 到 +50px
16 绿色垂直偏移 0–255 5–9: 居中, 10–255: -50px 到 +50px
17 蓝色水平偏移 0–255 5–9: 居中, 10–255: -50px 到 +50px
18 蓝色垂直偏移 0–255 5–9: 居中, 10–255: -50px 到 +50px

⚠️ 注意: 视频效果 (通道 3–18) 仅在视频输出启用时生效。对于仅音频播放,这些通道没有可见效果。

💡 3D 效果: 使用 RGB 时间偏移和位置偏移通道来创建色差和复古 3D 红蓝效果!

📁 灯具配置文件

下载适用于您的灯光控制台的现成灯库文件。这些配置文件允许您将 DMX TimeCode Player 配接为灯具,并直接从控制台进行控制。

可用配置文件

配置文件 通道 描述 下载
V2 - 标准模式 1 Ch 基础播放控制 (播放/暂停/停止) 下载
V3.1 - 循环模式 2 Ch 播放控制 + 循环计数 下载
V4.1 - 扩展模式 18 Ch 全功能控制,包括曲目选择、音量和视频效果 下载

安装说明

Obsidian Onyx

  1. 下载 .Fixture 文件
  2. 打开 Onyx 并前往 Patch → Add Fixtures
  3. 点击 Import Fixture
  4. 选择下载的 .Fixture 文件
  5. 将灯具配接到所需的 Universe 和地址

其他控制台

.Fixture 格式兼容多种灯光软件。如果您的控制台不支持此格式,请参考上方的 DMX 通道映射手动创建灯库。

💡 提示: 确保应用程序中的 DMX 模式与您的灯库匹配。前往 设置 → DMX → 模式 并选择相应的模式。

📱 Web 界面

通过网络浏览器从任何设备控制播放器。

访问 Web 界面

  1. 在设置面板中查看 Web 服务器 IP 地址
  2. 在手机、平板或电脑上打开浏览器
  3. 访问 http://[IP-ADDRESS]:8080

可用功能

📺 视频输出

输出视频到第二个显示器全屏显示,支持实时效果。

设置

  1. 将第二个显示器连接到您的 Mac
  2. 在设置中选择输出显示器
  3. 启用 "视频输出"
  4. 视频将全屏显示在选定显示器上

视频效果

🔗 CITP 集成

原生支持 CITP (控制器接口传输协议),用于与支持的灯光控制台集成。

支持的控制台

功能

🔧 故障排除

控制台未接收到时间码

无 DMX 控制

视频未在第二个显示器播放

首次启动应用显示"损坏"

在终端运行此命令:

xattr -cr "/Applications/DMX TimeCode Player.app"

🎭 使用案例 & 工作流程

DMX TimeCode Player 旨在灵活应用。以下是将其集成到灯光工作流程中的最常见场景。

🎧 场景 1: 手动播放 (DJ/操作员控制)

最适合: 现场活动,由 DJ 或专门的操作员控制音乐。

工作原理:

  • MacBook 与 DMX TimeCode Player 位于 DJ 台或音频操作员处
  • 在设置中启用 "手动模式" (禁用 DMX 输入)
  • 操作员根据需要手动选择并播放曲目
  • 曲目播放时,时间码自动广播到灯光控制台
  • 灯光控制台的 Timecode Cuelist 触发预编程的 Cue

💡 关键功能: 每首曲目以唯一的时间码偏移开始 (曲目 1 = 00:00:00:00, 曲目 2 = 01:00:00:00, 等等)。这意味着您的灯光控制台会自动知道正在播放哪首歌并触发正确的秀!

设置步骤:

  1. 将所有曲目加载到播放列表 (最多 24 首)
  2. 在控制台上将灯光 Cue 编程到特定时间码
  3. 在设置 → 禁用 DMX 输入 → 启用 "手动模式"
  4. 启用 "自动播放下一首" 如果想要连续播放
  5. DJ 播放任何曲目 → 灯光自动跟随

🎛️ 场景 2: 全 DMX 自动化 (单人秀)

最适合: 巡演、装置艺术或由单名灯光操作员控制的活动。

工作原理:

  • 灯光控制台发送 DMX 命令给 DMX TimeCode Player
  • 灯光操作员直接从控制台触发曲目
  • 无需专人控制播放
  • 音频/视频与灯光完美同步

💡 优势: 一人掌控一切!将播放器作为灯具添加到控制台,并在 Cuelist 中触发曲目,就像其他灯光命令一样。

设置步骤:

  1. 将 DMX TimeCode Player 配接为控制台中的灯具
  2. 下载并导入适用于您控制台的 灯库文件
  3. 配置 DMX 模式 (标准 1Ch, 循环 2Ch, 或 扩展 18Ch)
  4. 设置正确的 Universe/Subnet/Net 以匹配控制台输出
  5. 将曲目触发添加到 Cue 列表 (DMX 值 11-20 = 曲目 1, 21-30 = 曲目 2, 等等)

Cue 列表示例:

Cue 动作 DMX 值
1 演出开始 — 播放曲目 1 15
2 过渡 — 播放曲目 2 25
3 终场 — 播放曲目 3 35
4 结束演出 — 停止 0

📱 场景 3: 通过 Web 界面远程控制

最适合: 第三方 (舞台监督、制作人) 需要控制且无法接触控制台或笔记本电脑的情况。

工作原理:

  • DMX TimeCode Player 运行内置 Web 服务器
  • 同一网络上的任何人都可以通过手机或平板控制播放
  • 无需安装 App — 只需打开浏览器
  • 多人可同时访问

💡 适用于: 需要 Cue 音乐的舞台监督、控制伴奏的乐队指挥,或他人管理幻灯片音频的企业演示。

设置步骤:

  1. 确保所有设备在同一 WiFi 网络
  2. 在设置 → Web 服务器 中查找 IP 地址
  3. 在手机浏览器打开: http://[IP]:8080
  4. 使用 Web 界面播放/暂停/停止/选择曲目

⚠️ 安全提示: Web 界面无密码保护。请仅在本地网络中与受信任的团队成员共享 IP。

⚠️ 最多 24 首曲目: 由于 DMX 值范围 (11-245 分为 10 个值的段),播放列表最多支持 24 首曲目。每首曲目拥有唯一的 1 小时时间码窗口 (00:00:00:00 到 23:59:59:24)。

❓ 常见问题

软件是免费的吗?

是的!DMX TimeCode Player 完全免费,无订阅或限制。非常感谢捐赠支持,但这不是必须的。

支持哪些音频格式?

MP3, WAV, FLAC, AAC, M4A, 以及大多数常见音频格式。

支持哪些视频格式?

MP4, MOV, M4V, 以及大多数 macOS 系统支持的格式。

可以运行多个实例吗?

目前仅支持一个实例。运行多个实例可能会导致 Art-Net 端口冲突。

有 Windows 版本吗?

目前仅支持 macOS。未来可能会根据用户需求开发 Windows 版本。

如何报告 Bug 或请求功能?

通过电子邮件 (见页脚) 或 Instagram 联系开发者。