MIDI 语法

OnSong 使用基于文本的语法来表达 MIDI 命令。虽然您可以在元数据编辑器中使用 MIDI 事件，但您也可以在文本中表达 MIDI 命令。

分隔值

首先，多个 MIDI 命令可以由各种字符分隔，包括：制表符、逗号、分号、竖线或新行。逗号是最常见的分隔符。例如：

1.2:0@0, PC1.2:3@0, N67@1, START, SS8

通道

每个条目可能包含 @ 符号。该符号后面的数值是要发送命令的通道。由于 MIDI 中的通道从零开始，第一个通道是零 (0)，第二个通道是一 (1)，以此类推。

如果未使用 @ 符号，命令将在所有通道上发送或接收。

前缀

列表中的每个条目都包含一个前缀。此前缀确定要发送的 MIDI 命令类型。这些包括：

• PC 或无前缀是程序更改事件。
• N 是音符事件
• CC 是控制变更事件。
• SS 是歌曲选择事件。
• START 是开始命令。
• STOP 是停止命令。
• CONTINUE 是继续命令。
• F0 前缀为 SysEx 消息。

值

命令的值出现在 @ 符号之前或如果未给出 @ 的条目末尾。这是基于前缀的程序更改、控制变更、音符或歌曲选择的值。在 SysEx 条目的情况下，SysEx 的十六进制值直接在 F0 前缀之后提供，该前缀用作所有 SysEx 命令的标头。

子值

在某些情况下，额外信息在 MIDI 命令中作为子值传递。例如，MSB 和 LSB，以及控制值的速度可以这样发送。这是通过在值部分添加冒号来表达的。子值的上下文取决于发送的 MIDI 命令的类型：

• 程序更改的子值与程序更改的 MSB/LSB 对齐。这些值用句号分隔，MSB 在左边，LSB 在右边。
• 控制变更使用此值设置控制的值。该数字可以在 0 到 127 之间。如果省略，则推断值为 127。
• 音符事件的子值与应播放音符的速度有关。这可以设置为 0 到 127 之间的数值。

示例

让我们从一个简单的程序更改开始。在这种情况下，我们使用程序更改 8，它还在通道 1 上发送 MSB 4 和 LSB 2。该示例从这种最复杂的变体开始，并移除库选择和通道以变得更广泛：

PC3.1:7@0, 3.1:7@0, 3:7@0, 3:7, 7@0, 7

控制变更类似，不同之处在于语法的左侧是控制变更编号，右侧是可选值。如果未提供该值，则改为发送 127。我们将在通道 3 上发送控制变更 106，值为 64。

CC105:63@2, CC105:63. CC105@2, CC105

现在让我们看一下音符事件。我们想在通道 8 上以 75% 速度播放 C4，我们会输入以下内容，因为 OnSong 在 MIDI 音符刻度上从 0 开始计数 MIDI C0：

N60:95@7, N60@7, N60:95, N60

同样，重要的是要记住，随着值从 MIDI 语法中移除，MIDI 语句变得更加广泛和不具体。例如，音符事件的最后一个版本将在所有通道上以 100% 速度发送 C4。