简体中文

用游戏手柄控制舞台灯光

在 Mac App Store 下载 InputConfig这款应用完全免费。无需创建账户。没有订阅，没有麻烦的下载，也没有任何锁定的功能。针对 Apple 芯片优化。

你可以在 Mac 上用 Xbox 或 PlayStation 手柄运行 DMX 舞台灯光，不需要额外的桥接 App。InputConfig 把手柄变成 MIDI 设备，而人们真正在用的 Mac 灯光 App，QLC+、Lightkey 和 MagicQ，本来就会监听 MIDI。握紧一个扳机，灯光就渐亮。轻按一个按钮，一个场景就亮起来。

这一篇起因于 Reddit 上的一个问题：有人想用 Xbox 手柄运行灯光系统，而我坐下来回答时发现，它其实已经能用了。你大约半小时就能从手里的手柄走到架子上的灯。第一次握紧扳机让一盏真正的灯渐亮时，你会很难放下手柄。

InputConfig 1.7 版预计于 2026 年 10 月发布，届时应用将完整支持简体中文。

步骤

  1. 连接手柄并打开 InputConfig。
  2. 从这一页下载 Lighting Desk 预设，双击把它添加到 InputConfig，然后打开。
  3. 打开你的灯光 App（QLC+、Lightkey 或 MagicQ），选 InputConfig 作为 MIDI 输入。
  4. 连接 USB-DMX 接口或者 Art-Net 或 sACN 节点，并在灯光 App 里把你的灯具配接到它。
  5. 学习每个控制：在 QLC+ 里对 Virtual Console 的推子或按钮使用 Auto Detect，在 Lightkey 里右键点按一个提示或推子并添加触发，然后移动手柄上对应的控制。
  6. 把场景按钮设为切换，两个肩键设为闪光，并把全黑和全部停止的按钮放在容易够到的地方。

备齐需要的东西

  • 一个手柄。Xbox、PlayStation、Switch Pro、8BitDo，InputConfig 能看到的都行。只要它出现在 App 里，在这里就能用。飞行摇杆、方向盘和踏板会以完整分辨率读取每个轴，所以油门杆或踏板也可以当推子。
  • InputConfig。在 Mac App Store 免费。
  • 一个灯光 App。QLC+ 免费、开源，并在 Apple 芯片上原生运行。Lightkey 只支持 Mac，而且好上手。ChamSys 的 MagicQ 也行，但它的 MIDI 输入并非每个版本都有，所以请先查 ChamSys 的文档。
  • 能和灯光通信的东西。一个 USB-DMX 接口（Enttec DMX USB Pro 使用 macOS 已内置的驱动），或者你网络上的 Art-Net 或 sACN 节点。

如果你还没有灯，QLC+ 会在屏幕上显示每一盏灯具，所以你可以在插上任何东西之前，先把一切搭好并测试。InputConfig 和 QLC+ 都免费。你唯一可能要买的是接口或节点。

了解各部分如何沟通

InputConfig 在你的 Mac 上创建一个名为 InputConfig 的 MIDI 端口。其他每个 App 看到它，就和用线缆插上的 MIDI 控制器完全一样。它从不离开你的 Mac，所以没有网络设置，也不需要安装驱动。两种消息完成了所有工作：

MIDI CC（控制变化）
随着你移动，扳机或摇杆发送从 0 到 127 的平滑数值。扳机静止在 0，这对调光器来说再合适不过：一松手，推子就完全降到底。
MIDI 音符
按钮在你按住时发送音符开，松手时发送音符关。灯光 App 决定这意味着切换一个场景，还是只在按住时闪光。

扳机是推子，按钮是场景，每一个的含义由灯光 App 决定。

在 InputConfig 里设置手柄

最快的开始，是这一页上的 Lighting Desk 预设。一切都从 MIDI 通道 1 发出：

控制发送适合用于
右扳机CC 1总调光
左扳机CC 2频闪速度、烟雾或颜色
右摇杆向上CC 3第三个推子
A、B、X、Y音符 36 到 39场景 1 到 4
LB、RB音符 40、41闪光
方向键音符 42 到 45下一个提示、上一个提示、追逐
Start音符 46全黑
Back音符 47全部停止
编辑器里的灯光控台预设，扳机上是 MIDI CC 行，按钮上是 MIDI 音符行。
Figure 1. 扳机发送 CC 1 和 CC 2，按钮发送音符 36 到 47，全部在通道 1 上。
  • 你：打开下载的文件，把它添加到 InputConfig，然后打开。
  • InputConfig：在 InputConfig 端口上发送这些 CC 和音符。发送 CC 的摇杆一过了死区就达到完整的 0 到 127，所以右摇杆推子能一路升到顶。
  • 检查：在 PlayStation 手柄上，给预设一个灯条颜色：在边栏里选中它，点按 Live Visualizer 手柄图里 L2 和 R2 之间的 Light bar 标签。看一眼手柄，就知道灯光布局正在运行。

想自己建一个的话，添加一行，按 Scan，移动控制，然后选 MIDI CC 或 MIDI Note 作为输出。MIDI CC 工具能帮你看到哪些数字已经用过了。

在 QLC+ 里连接

第 1 步：选择输入和输出

  • 你：打开 Inputs/Outputs 标签页。在 universe 1 上，勾选 InputConfig 作为 MIDI 输入，并选你的 DMX 接口或 Art-Net 作为输出。
  • QLC+：在那个 universe 上监听 InputConfig 端口。
  • 检查：移动一个扳机，universe 的输入指示灯有反应。

第 2 步：学习推子和场景

  • 你：在 Virtual Console 里为你的调光器添加一个推子。在它的属性里，在外部输入下打开 Auto Detect，然后握紧右扳机。用同样的方式添加场景的按钮：关联场景，打开 Auto Detect，按 A。
  • QLC+：把每个控件绑定到你移动的控制上，并把 0 到 127 的 MIDI 范围加倍到 DMX 的 0 到 255，所以完全握紧就真的是满值。
  • 检查：推子跟随扳机，A 调出场景。

第 3 步：设置按钮的行为

  • 你：把场景按钮设为 Toggle Function on/off，把 LB 和 RB 按钮设为 Flash Function。把 Start 指向 Toggle Blackout，把 Back 指向 Stop All Functions。
  • QLC+：切换场景，并只在你按住肩键时点亮闪光场景。
  • 检查：松开一个肩键，它的闪光就熄灭。

在 Lightkey 里连接

  • 你：打开 External Control 窗口，点按 MIDI，从 Input 菜单里选 InputConfig。然后右键点按一个提示或推子，选择添加触发，按下你想用的按钮或移动想用的扳机。
  • Lightkey：当场学习这个控制。
  • 检查：提示由手柄触发。设置一整场演出只需要几分钟。

用按钮移动灯头，别用摇杆

你可以把水平和俯仰放在摇杆上，对于大幅度的扫动，这非常好玩。限制是：一个 MIDI CC 只有 128 个级别，所以缓慢而精确的移动可能看起来有点一格一格的。演出时，请在灯光 App 里保存你的位置，把它们放在按钮上，让 App 自带的效果去处理移动。

留一个紧急按钮

灯光是现场实时的，所以要为出错的时刻做好打算。沿着这个阶梯往上爬，先做最小的一步：

  1. 全黑。Start，远离你会狂按的那些按钮。
  2. 全部停止。Back，在 Xbox 手柄上是 View，在 DualSense 上是 Create。
  3. 停止 InputConfig。Back 开箱就是 InputConfig 自己的紧急停止的一半：普通按下会向灯光 App 发送全部停止，同时与 Start 按住三秒会让 InputConfig 本身停下，它会为自己按住的每个音符发送音符关，并停止所有输出。

如果你想把两者分开，在 Settings, General 里把紧急停止挪到另一个按钮上。真正的演出请用线缆，不要用蓝牙，并提前给手柄充好电。排练时蓝牙没问题。线缆则少一件要操心的事。

其他做法

这件事上我有点偏心，所以也把其他路线列出来：

  • Chataigne。免费，直接读取游戏手柄并发送 DMX、Art-Net 或 OSC。如果灯光是你唯一需要的东西，这很棒，而且如果你有朝一日需要桥，也用它。常被推荐的 OSCulator 已在 2024 年底停止运营。
  • QLC+ 自己的 HID 插件。能读取手柄，但它的文档里写的是适用于 Windows 和 Linux。
  • InputConfig。当同一个手柄还需要在你的 Mac 上运行按键、鼠标或音乐时，或者你想要一套在每个 App 里都能用的设置时，它更合适。

MIDI 键盘或推子盒可以同时运行。灯光 App 把它和 InputConfig 看作单独的输入。想用 OSC 而不是 MIDI，请看 Mac 上的游戏手柄转 OSC。

简短总结

  • 添加 Lighting Desk 预设。扳机是推子，按钮是场景，在 MIDI 通道 1 上。
  • 选 InputConfig 作为 MIDI 输入。在 QLC+、Lightkey 或 MagicQ 里做，然后学习每个控制。
  • 场景切换，肩键闪光。全黑和全部停止放在 Start 和 Back 上。
  • 演出用线缆。也要先给手柄充好电。

任何能学习 MIDI 的灯光 App，都可以用手柄来演奏。

常见问题

我需要 OSCulator 或其他桥接 App 吗？

QLC+、Lightkey 或 MagicQ 不需要。它们直接读取 InputConfig 的 MIDI 端口。如果你看到有人推荐 OSCulator，它已在 2024 年底停止运营，所以如果你真需要桥，我会用 Chataigne。

它能用于 PlayStation 或 Switch 手柄吗？

InputConfig 能看到的任何手柄都行，因为灯光 App 看到的只有 MIDI。

我能同时使用 MIDI 键盘或推子盒吗？

你的灯光 App 把 InputConfig 和你其他的 MIDI 设备看作单独的输入，所以你可以随意混用。

这个免费吗？

InputConfig 免费，QLC+ 也免费。你唯一可能要买的是 USB-DMX 接口或 Art-Net 节点，用来连到真正的灯。

更多中文页面

详细指南（英文）

作者说明。Ryleigh Newman 开发了 InputConfig，因为双手活动不便，每天都用手柄操作自己的 Mac。本页译自英文。Mac 的语言设为简体中文时，App 的主要按钮和菜单显示为中文，本页使用这些名称，并在括号中附上英文名称。App 的其他部分和网站的其他页面都是英文。

本页的其他语言版本： English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文

在 Mac App Store 下载 InputConfig免费。macOS 14 或更高版本。无需账户，数据不会离开你的 Mac。 源代码在 GitHub 上.