元数据

元标签是一种提供歌曲信息的方式，用元数据部分表示。元数据在歌曲的第一部分表示，位于第一个空白行之前或直到不再有元标签为止。元标签是名称/值对，其中名称在左边，值在右边，用冒号分隔。每行只能出现一个元标签。有关如何以 ChordPro 格式表示元数据的详细信息，请参考 ChordPro 文件格式。

如果第一行不是元标签格式，OnSong 会自动将文本文件的第一行指定为歌曲的标题。此外，除非定义了元标签，否则第二行被视为歌曲的艺术家/署名。以下是一个典型的歌曲元数据部分示例，将标题和艺术家设置为第一行和第二行，以及调性和速度。

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

元标签

OnSong 支持以下标签：

• Title： 歌曲的标题。这也可以在歌曲内容的第一行表示。
• Artist： 艺术家名称或任何其他署名信息。这也可以在歌曲内容的第二行表示。您可以通过用分号分隔名称来指定多个艺术家。 - Kim Walker-Smith; Chris Quilala
• Author： 创建和弦图的人员的名称。这显示在和弦图的底部和歌词投影中。
• Key： 歌曲的调性，写作方式为具有异名偏好的调性，可选加上"m"表示小调。 - 字母形式，例如 Bb 或 Em
• TransposedKey： 歌曲应演奏的所需调性，可能与歌曲中写作的调性不同。 - 字母形式，例如 Bb 或 Em
• In： 是移调调性元标签的别名。
• Capo： 设置为品数的变调夹。这通常是正整数（1 到 11），但也可以是负整数。 - 数字
• Tempo： 每分钟拍数 (BPM)。 - 数字
• Time： 拍号。 - 数字拍号，例如 3/4
• Duration： 歌曲长度，用于自动滚动。 - 秒或 mm:ss
• Book： 书籍或多本书籍的名称，用于将歌曲放入其中。这是一个逗号分隔的书籍名称列表，歌曲将被放入其中。如果书籍不存在，它也会被自动创建。
• Number： 歌曲的编号 - 数字。用于赞美诗、年份等。您可以按编号对歌曲进行排序以供参考。
• Flow： 部分的排列。 - 部分标签列表。 有关安排歌曲流程的详细信息，请参见 Flow。
• MIDI： 查看歌曲时要发送的 MIDI 命令。有关如何在 OnSong 中将 MIDI 命令表示为文本，请参见 MIDI 语法。
• MIDI-Index： 将在 Song Viewer 中打开此歌曲的 MIDI 命令。有关如何在 OnSong 中将 MIDI 命令表示为文本，请参见 MIDI 语法。
• Keywords： 或 Topic： 用于主题搜索的标签列表。有关按主题浏览的更多信息，请参见 Topics。
• Copyright： 或 Footer： 或 f： 歌曲的版权信息。这将显示在和弦图和歌词投影的底部。
• CCLI： 歌曲的 CCLI 编号。这将显示在和弦图和歌词投影的底部。
• Restrictions： 这些是防止在歌曲中执行某些操作的限制。有关为歌曲设置限制的详细信息，请参见 Restrictions。
• Pitch： 使用 Pitch Pipe 功能时要播放的音符或音符。这被定义为空格分隔的音符列表，可选带八度。 - 例如 A3 C#4 E5
• Subdivision： 或 Beat： 让您为歌曲选择细分。这可以是一个值，包括：whole、half、quarter、eighth、shuffle 或 sixteenth。或者，您可以使用整数，如 1、2、4、8 或 16。
• Transpose： 转调歌曲的半音数。这用于在歌曲中间调制歌曲的上升或下降，并根据转调滑块中设置的调性进行调整。此数字必须是正整数或负整数。
• Tuning： 指定给歌曲的乐器调音。这些是特定于乐器的，目前只有吉他支持这些值：Standard、Celtic、Drop D、Drop DD、Drop C、Drop B、Drop A、Open C、Open D、Open G 或 Open E。
• Scene： 加载歌曲时要播放的场景。这可以通过在冒号后输入场景名称来设置。

内联标签

某些标签可以在歌曲中使用以影响歌曲中间的转调。这些包括：

• Capo： 可用于在歌曲中间应用变调夹，调制歌曲以提供使用变调夹弹奏的和弦。您可以在 Capo Settings 中调整调制方向。这通常是正整数（1 到 11），但也可以是负整数以移除之前的变调夹。 - 数字
• Key： 在歌曲中显式设置调性。如果在使用带括号的和弦时用括号将值括起来，生成的调性也将被转调。 - 字母形式，例如 Bb 或 Em
• Transpose： 将歌曲转调所需的半音数。这是正整数或负整数。例如，使用 2 或 +2 将歌曲转调上升一个全音，或使用 -3 将歌曲转调下降三个半音。 - 数字

部分标签

某些标签可用于提供有关歌曲每个部分的信息。这些包括：

• MIDI： 选择部分时要发送的 MIDI 命令。有关如何在 OnSong 中将 MIDI 命令表示为文本，请参见 MIDI 语法。
• Scene： 选择部分时要播放的场景。这可以通过在冒号后输入场景名称来设置。

注意：元标签不区分大小写