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 消息的前缀。
• WAIT 实现延迟。

值

命令的值出现在 @ 符号之前，或者如果没有给出 @ 则在条目的末尾。这是根据前缀的程序更改、控制更改、音符或歌曲选择的值。在 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 上发送值为 64 的控制更改 106。

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

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

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

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

要在其他 MIDI 事件之间实现延迟，请使用带有数字的 WAIT 命令。该数字可以是整数值。您可以将等待秒数定义为 1-10，或定义为毫秒。下面显示如何等待 2 秒、10 秒和半秒。

WAIT2, WAIT10, WAIT500