元数据

元标签是提供歌曲信息的一种方式，以元数据部分表示。元数据在歌曲的第一部分表示，位于第一个空白行之前或直到没有更多元标签为止。元标签是名称/值对，其中名称在左边，值在右边，由冒号分隔。每行只能出现一个元标签。请参考 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)： 部分的排列。- 部分标签列表。 有关排列歌曲流程的详细信息，请参阅 流程。
• MIDI： 查看歌曲时要发送的 MIDI 命令。请参阅 MIDI 语法 了解如何在 OnSong 中将 MIDI 命令表示为文本。
• MIDI-Index： 将触发在 歌曲查看器 中打开此歌曲的 MIDI 命令。请参阅 MIDI 语法 了解如何在 OnSong 中将 MIDI 命令表示为文本。
• 关键词 (Keywords)： 或 主题 (Topic)： 用于主题搜索的标签列表。有关按主题浏览的更多信息，请参阅 主题。
• 版权 (Copyright)： 或 页脚 (Footer)： 或 f： 歌曲的版权信息。这将出现在和弦谱和歌词投影的底部。
• CCLI： 歌曲的 CCLI 编号。这将出现在和弦谱和歌词投影的底部。
• 限制 (Restrictions)： 这些是防止在歌曲中执行某些操作的限制。有关为歌曲设置限制的详细信息，请参阅 限制。
• 音高 (Pitch)： 使用 音高管 (Pitch Pipe) 功能时要播放的音符。这定义为以空格分隔的音符列表，可选包含八度音。- 例如 A3 C#4 E5
• 细分 (Subdivision)： 或 拍子 (Beat)： 让您选择歌曲的细分。这可以是一个值，包括：whole（全音）、half（半音）、quarter（四分音）、eighth（八分音）、shuffle（切分音）或 sixteenth（十六分音）。或者，您可以使用整数，如 1、2、4、8 或 16。
• 移调 (Transpose)： 歌曲半音移调的数量。这用于在歌曲中途调制歌曲上下，并与转调滑块中设置的调性相适应。此数字必须是正整数或负整数。
• 场景 (Scene)： 加载歌曲时要播放的场景。这可以通过在冒号后输入场景名称来设置。

内联标签

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

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

部分标签

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

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

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