元数据

元标签是一种提供歌曲信息的方式，在元数据部分中表示。元数据在歌曲的第一部分中表示，位于第一个空行之前或直到不再出现元标签为止。元标签是名称/值对，其中名称在左边，值在右边，两者用冒号分隔。每行只能出现一个元标签。请参考 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: 将触发在 歌曲查看器 中打开此歌曲的 MIDI 命令。有关如何在 OnSong 中将 MIDI 命令表示为文本的信息，请参阅 MIDI 语法。
• Keywords: 或 Topic: 用于主题搜索的标签列表。有关按主题浏览的更多信息，请参阅 主题。
• Copyright: 或 Footer: 或 f: 歌曲的版权信息。这将显示在和弦图和歌词投影的底部。
• CCLI: 歌曲的 CCLI 编号。这将显示在和弦图和歌词投影的底部。
• Restrictions: 这些是阻止在歌曲中执行某些操作的限制。有关为歌曲设置限制的详细信息，请参阅 限制。
• Pitch: 使用 音高管 功能时要播放的音符。这定义为空格分隔的音符列表，可选的八度音程。- 例如 A3 C#4 E5
• Subdivision: 或 Beat: 让您为歌曲选择细分。这可以是一个值，包括：全音、二分音符、四分音符、八分音符、shuffle 或十六分音符。或者，您可以使用整数，如 1、2、4、8 或 16。
• Transpose: 转调歌曲的半音数。这用于在歌曲中途调制歌曲上升或下降，并与转调滑块中设置的调式相适应。这个数字必须是正整数或负整数。
• Tuning: 指定给歌曲的乐器调音。这些特定于乐器，目前仅支持吉他，这些值为：标准、凯尔特、Drop D、Drop DD、Drop C、Drop B、Drop A、Open C、Open D、Open G 或 Open E。
• Scene: 加载歌曲时要播放的场景。这可以通过在冒号后输入场景的名称来设置。

内联标签

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

• Capo: 可用于在歌曲中途应用变调夹，调制歌曲以提供带有所应用变调夹的和弦。您可以在 变调夹设置 中调整调制方向。这通常是正整数（1 到 11），但也可以设置为负整数以移除之前的变调夹。- 数字
• Key: 在歌曲中明确设置调式。如果使用方括号和弦时用方括号包围该值，生成的调式也将被转调。- 字母表示，例如 Bb 或 Em
• Transpose: 转调歌曲所需的半音数。这是正整数或负整数。例如，使用 2 或 +2 将歌曲转调上升一个全音符，或使用 -3 将歌曲转调下降三个半音。- 数字

部分标签

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

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

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