---
title: "MIDI"
description: "使用 MIDI 控制器触发场景切换、通过 MIDI 学习 映射打击垫，实现现场演出中的实时播放控制。"
url: "https://flosync.com/zh-cn/docs/midi/"
lang: "zh-CN"
updated: "2026-09-24"
---

# MIDI 控制器支持

FloSync 支持通过 MIDI 控制器在现场演出中直接触发场景。连接控制器后，即可用打击垫或按钮触发间隔场景，LED 灯实时指示当前播放的场景。

MIDI 配合间隔排程使用：将每个场景绑定到一个打击垫，在[上线直播](https://flosync.com/zh-cn/docs/go-live/)期间按下打击垫即可切场。

## 支持的控制器

FloSync 兼容所有 MIDI 控制器，并为以下设备提供增强的 LED 反馈：

| 控制器 | LED 支持 |
| --- | --- |
| **Novation Launchpad**（X、Mini MK3、Pro MK3、MK2 及旧款型号） | 完整 127 色调色板 + SysEx RGB |
| **Akai APC**（APC40 MK2、APC Mini MK2） | 128 色力度调色板 |
| **Akai APC**（经典 APC40、APC Mini） | 6 色调色板（红、绿、黄） |
| **Arturia Minilab 3** | 通过 SysEx 实现完整 RGB |
| **Native Instruments Maschine**（MK2、MK3、Mikro、Jam） | 17 色力度映射 |
| 其他 MIDI 控制器 | 基于力度的基础亮度控制 |

## 配置 MIDI

### 1. 启用 MIDI

1. 打开**偏好设置**（macOS 快捷键 ⌘,；Windows 快捷键 Ctrl+,）
2. 向下滚动找到 **MIDI 控制** 部分
3. 开启 **启用 MIDI 控制**
4. 点击 **保存**

### 2. 选择设备

在偏好设置的 **设备** 下拉菜单中选择您的 MIDI 控制器。如果刚接入了新设备，点击刷新按钮重新扫描。

### 3. 将场景映射到打击垫

*计划图标，位于工具栏右侧。*

1. 打开**计划面板**（点击工具栏中的计划图标）
2. 切换到 **按间隔播放模式**
3. 点击任意场景上的 **MIDI 学习** 按钮
4. 在控制器上按下想要绑定的打击垫或按钮
5. 映射会自动保存

### 4. 设置 LED 颜色

1. 点击已映射场景旁边的**调色板**图标
2. 从预设颜色中选取，也可以用滑块自定义数值
3. 不同控制器对颜色的呈现各有差异，建议多试几种，以找到最佳效果

如需清除映射，点击已映射场景旁边的**清除映射**即可。

## 在直播模式中使用 MIDI

完成场景映射并进入[上线直播](https://flosync.com/zh-cn/docs/go-live/)后：

- 按下任意已映射的打击垫，即可瞬间切换到对应场景
- 当前场景的 LED 以设定颜色全亮显示，其余已映射场景亮度降低
- MIDI 触发的效果与键盘控制完全一致，适用于间隔场景
- 通过 MIDI 触发的场景切换同样会同步到网络客户端（以服务端身份运行时）

## LED 反馈

启用 MIDI 并连接控制器后：

- **当前场景**：LED 以指定颜色全亮显示
- **其他已映射场景**：LED 以较低亮度显示
- **未映射的打击垫**：不受影响

可在计划面板中通过调色板图标为每个场景单独设置颜色。

## MIDI 消息类型

FloSync 支持以下几种 MIDI 消息类型来触发场景：

| 消息类型 | 触发条件 |
| --- | --- |
| **Note On** | 力度值 > 0 |
| **Control Change** | 映射控制器编号上的任意数值 |
| **Program Change** | 任意 Program 编号 |

## MIDI 与网络同步

在服务端/客户端模式下：

- **服务端**收到 MIDI 触发后，会将场景切换广播给所有客户端

- **客户端**在直播模式下不响应本地 MIDI 输入

- 这一机制确保通过 MIDI 控制时所有电脑严格保持同步

- 您的 MIDI 映射会作为每个场景的一部分保存，因此会随您的 `.flo` 配置文件一同保留。导出或导入配置时会带上其中的映射。映射记录的只是 MIDI 通道、消息类型以及该消息携带的音符、控制器或 Program 编号，而不是具体的控制器型号。因此，如果另一台电脑使用的是不同的控制器，打击垫的位置可能对不上，您可能需要在那台电脑上重新学习映射。

- 映射本身不会通过网络同步传递：当客户端从已连接的服务端导入场景内容时，其中不包含 MIDI 映射。

## 自动重连

断开再重新接入 MIDI 控制器时，FloSync 会自动重连并恢复所有映射，无需手动重新配对。

## 相关文档

- [上线直播](https://flosync.com/zh-cn/docs/go-live/)：直播模式下的场景导航与键盘控制
- [排程](https://flosync.com/zh-cn/docs/scheduling/)：设置间隔场景以配合 MIDI 触发
- [网络同步](https://flosync.com/zh-cn/docs/network-sync/)：MIDI 触发如何同步到网络客户端
- [偏好设置](https://flosync.com/zh-cn/docs/preferences/)：MIDI 开关与设备选择