用户手册：Maestro Level Editor (版本 1.1.0)

1. 入门指南

安装与文件

首次运行编辑器时，它会自动在您的系统中创建一个文件夹：我的文档\Maestro\Levels

您的所有关卡（.maestro 文件）都将保存到此位置并从此位置加载。编辑器还将关联 .maestro 文件，因此您可以双击直接打开它们。

主菜单

主屏幕是您的操作中心。从这里，您可以管理所有项目。

• Level List: 这个中央面板显示了您所有已保存的关卡。您可以点击列标题（Piece Name, Composer, Level Creator, Last Modified）来对列表进行升序或降序排序。排序箭头（▲/▼）将指示当前的排序方向。
• Search Bar: 使用顶部的搜索字段，通过输入作品名称、作曲家、关卡创作者或文件名的任何部分来过滤您的关卡。搜索不区分重音符号，因此搜索 "Dvorak" 也会找到 "Dvořák"。
• New: 从头开始创建一个全新的关卡。
• Open: 从列表中加载选定的关卡以继续编辑。您也可以在列表中双击关卡。
• Import: 打开文件资源管理器，将一个或多个 .maestro 文件从 PC 的任何位置复制到您的 Levels 文件夹中。这是添加他人与您共享的关卡的理想方式。
• Delete: 永久删除您在列表中选择的关卡。将需要您进行确认。
• Refresh: 在您手动添加或删除文件的情况下，重新加载关卡列表。
• Clear Cache: 删除临时音频数据。这有助于解决故障或释放磁盘空间。
• Exit: 关闭应用程序。
• Workshop: 打开 Steam Workshop 浏览器，以发现、下载、投票和管理社区创建的关卡。

在右侧，您会找到用于调整应用程序的 Graphics Quality (Performance, Balanced, Quality, Ultra) 和 Display Mode (Windowed, Borderless, Fullscreen) 的下拉菜单。首次启动时，编辑器会自动检测您的硬件（GPU 和系统内存）并选择最合适的图形预设。您的偏好将保存以供将来的会话使用。 您还可以通过单独的下拉菜单更改界面语言。

2. 编辑器界面

创建或打开关卡后，您将进入主编辑器界面。它被划分为代表工作流程的五个选项卡：

• Setup: 定义关卡的信息、外观和乐器编制。
• Audio: 加载并混合每种乐器的音频文件。
• Animation: 定义音乐家的动画，以便他们对音乐做出视觉反应。
• Gameplay: 最关键的部分！在这里您放置玩家为指挥交响乐团必须遵循的图标。
• Preview: 检查关卡的“卡片”在游戏中的显示效果。

在顶部，您将始终拥有一个包含基本功能的公共工具栏：

• Save: 将所有更改保存到 .maestro 文件中（完整的保存行为请参见第 4 节）。
• Delete Icon: 删除选定的 Gameplay 或 Animation 图标。
• Undo / Redo: 您最好的盟友。它们允许您撤销或重新应用大部分操作。
• Help: 随时显示本用户手册。
• Return to Main Menu: 关闭当前关卡并让您返回主菜单。如果您有未保存的更改，将出现一个对话框，询问您是要 Save and Exit, Exit without Saving 还是 Cancel。

关卡助手

在顶部栏中，您会找到 关卡助手 按钮。在您工作时，它每隔几秒就会检查一次您的关卡，其彩色标记会告诉您还有多少地方可以改进。点击它会打开一个窗口，每条建议对应一张卡片，并按重要程度排序（重要、推荐、建议）。

• 一键修复: 许多卡片都有一个可以替您解决问题的按钮（例如 全部同步、添加预备小节、同步音频、生成箭头、从 MIDI 导入 或 转换演奏法）。在做任何更改之前，助手都会准确告诉您将会发生什么，并且每次修复都可以用一次 Ctrl+Z 撤销。
• 前往: 带您进入可以自行修复该问题的选项卡。
• 忽略: 隐藏您不需要的建议。被忽略的建议会针对该关卡记住，您可以通过窗口底部的 已忽略 将它们恢复。
• 检查内容: 缺少关卡信息、封面图像或乐谱 PDF；没有音频或没有 MIDI 轨道的乐手；未与 MIDI 同步的乐手；MIDI 与音频没有同时开始；音乐从第 0 小节开始；与 MIDI 不一致的 Tempo 和拍号；没有指挥箭头的音乐小节；缺少结束小节线；Maestro 无法读取的 MIDI 演奏法；以及关卡是否曾经保存过。

3. 逐步指南：创建一个关卡

第 1 步：Setup 选项卡

这是起点。在这里您定义作品的身份。

A. 作品信息

填写文本字段。这是玩家将看到的信息。

• Piece Name: 主标题（例如，“第 5 号交响曲”）。
• Piece Sub-Name: 副标题或乐章（例如，“I. 灿烂的快板”）。
• Composer: 作品的作曲家（例如，“路德维希·凡·贝多芬”）。
• Description: 简短描述或趣闻。
• Level Creator: 您的名字或别名！

  注意: 在每个文本字段旁边，您会看到一个字符计数器 (XX / YY)，以帮助您保持在限制范围内。如果您超过最大长度，它会变成红色。

B. BPM 和视觉效果

• BPM: 设置作品的初始 Tempo。此值可以在稍后的 Gameplay 选项卡中更改。
• Musical Period: 从下拉菜单中选择作品的历史时期：Renaissance, Baroque, Classical, Romantic, 20th Century, 或 21st Century。上传至 Steam Workshop 时，将自动应用此标签以进行过滤。
• Cover Image: 选择封面艺术图。要求: 16:9 格式，最大分辨率 1920x1080。
• Score Art: 游戏中显示在指挥台上的图像。要求: 250:169 格式，最大分辨率 4000x2704。
• Stage Screens: 此开关允许您显示或隐藏在某些音乐厅中经常出现的大屏幕。

C. 乐团选择

在这里，模拟器变得栩栩如生。

• Concert Hall: 从十一个可用的音乐厅中选择一个。每个音乐厅的声学效果、外观和乐团容量各不相同：
  • 大礼堂 — 大型交响乐场馆，可容纳最大规模的乐团。
  • 交响音乐厅 — 适合大型编制的标准音乐厅。
  • 古典剧院 — 对部分乐器有限制的剧院舞台。
  • 皇家剧院 — 支持合唱团、设有乐器互斥规则的典雅剧院。
  • 宫殿厅 — 适合小型编制的私密室内乐空间。
  • 排练厅 — 适合小型团体和独奏的紧凑空间。
  • 星光厅 — 采用温暖木材和星空天花板的大型现代音乐厅。
  • 演播厅 — 小型礼堂，适合室内乐团和独奏会。
  • 大教堂 — 拥有悠长混响的宏伟教堂。
  • 极光厅 — 舞台上方设有电影银幕、可举办电影交响音乐会的现代音乐厅（见 E 部分）。
  • 爱乐厅 — 观众席呈梯田状环绕舞台的大型现代音乐厅。
• 编制: 部分音乐厅提供多种乐手排布，例如交响乐团（经典排布）或交响管乐团（管乐和打击乐，无弦乐）。只有当所选音乐厅拥有多种编制时才会显示此下拉菜单。更换编制时，能容纳的乐器会保留，其余的会变为 0。
• 预设: 一键布置整个舞台：清空舞台、所有乐器、乐器与合唱团或仅合唱团。只会显示对当前音乐厅和编制有意义的选项。选择将当前保存为预设…可保存您自己的配置（最多 30 个）。您的预设可用于任何关卡和音乐厅，并会自动适应舞台的限制。要删除您自己的预设，请先应用它，然后按两次垃圾桶按钮。预设保存在您的电脑上，而不是 .maestro 文件中，每次应用都可以用一次 Ctrl+Z 撤销。
• Instruments: 使用下拉菜单选择您希望为每种乐器配备多少位音乐家。可用选项将根据所选的音乐厅而变化。有些大厅有排他性限制（例如，您不能同时拥有钢琴和拨弦古钢琴，或者在某些大厅中木管乐器和合唱团相互排斥）。

提示: 设置乐团时，您可以使用底部的 8 个摄像机按钮 更改 3D 视图，查看您的选择在舞台上的效果。

D. MIDI 导入（可选但推荐）

您可以加载一个包含作品乐谱的标准 MIDI 文件 (.mid)。这充当编辑器的“数字乐谱”。

• Select MIDI: 单击此按钮加载您的文件。加载后，编辑器可以使用这些数据自动同步 Tempo、制作音乐家动画以及检测演奏技巧 — 所有这些都无需您手动放置每一个图标。保存时，MIDI 文件会嵌入到 .maestro 文件中。

加载 MIDI 文件时，编辑器还会为您准备好以下几项：

• 为每位乐手分配 MIDI 轨道: 每位乐手都会获得与其名称或乐器相匹配的 MIDI 轨道。编辑器能识别多种语言的乐器名称、声部编号（例如 "Violin 2"）以及 General MIDI 乐器。它只会填写 Animation 选项卡中的下拉菜单：未经您同意，Sync MIDI 永远不会被开启。
• Tempo 和拍号: MIDI 中的 Tempo 和拍号变化会自动导入到 Gameplay 选项卡中（效果与按下 Smart MIDI Analysis 相同）。
• 演奏法: 许多记谱软件记录拨奏 (pizzicato)、弓杆奏 (col legno)、弱音器和打击乐器的方式是 Maestro 无法直接读取的（使用 MIDI 通道，或使用 "pizz."、"arco"、"col legno"、"con sord." 或 "senza sord." 等文字标记）。编辑器会将它们转换为 Maestro 的格式，让乐手按乐谱演奏。MIDI 的声音完全不变，并且一次 Ctrl+Z 即可撤销转换。技巧变化会被稍微提前（最多一个小节，并且仅在中间没有音符时），让乐手有时间做好准备。已与 MIDI 同步的乐手不会被更改。打击乐的单击和滚奏不会自动转换：您可以在 MIDI 编辑器中标记它们（见步骤 3）。
• 打击乐: MIDI 中的打击乐会分配给舞台上的打击乐手（铙钹、辅助 A、辅助 B、小军鼓、大鼓）：每位乐手都会获得自己的 MIDI 轨道和换乐器设置。在 Setup 中添加或移除打击乐手时会重新分配；如果缺少某位乐手（例如三角铁需要辅助 B），关卡助手会提醒您。您手动选择了 MIDI 轨道的打击乐手永远不会被更改，您已在 MIDI 中准备好的轨道会按原样使用。一次 Ctrl+Z 即可撤销。
• 加载新版本的 MIDI: 如果您在 MIDI 编辑器中更改了演奏法，然后加载了修正后的 MIDI 版本，编辑器会询问 要保留你在 MIDI 编辑器中所做的修改吗？ 选择 应用，可将您对拨奏、弓杆奏、弱音器和打击乐器的更改复制到新 MIDI 中相同的音符上（相同轨道、相同音高、相同时刻）；或选择 不，按原样使用新的 MIDI。

MusicXML（可选）

MIDI 旁边有一个 MusicXML 栏。MusicXML 文件是从记谱软件（MuseScore、Sibelius、Finale、Dorico…）导出的乐谱，它保留了 MIDI 文件会丢失的细节，例如连线和演奏法。编辑器会用它来改进您的 MIDI，让乐手的演奏更贴近乐谱。加载 MIDI 后该按钮才会启用。

• 格式: .musicxml、.mxl（压缩）和 .xml。不读取 MuseScore 文件（.mscz）：请在 MuseScore 中使用“文件 > 导出 > MusicXML”。
• 改进内容: 连线：连线下的音符会极轻微地重叠，因此弦乐手会持续运弓，并在乐句之间换弓。没有连线的音符会稍微分开一点，避免重叠（在震音中尤其明显）。此外，它还会缩短断音音符，让重音稍微更强，把震音写成音符，添加 pizz.、arco、col legno 和弱音器，为每个打击乐音符指定乐器，并把乐谱中的力度记号（p、f、crescendo…）交给智能力度使用。
• 以 MIDI 为准: 不会添加或删除任何音符：只改变演奏方式。如果 MIDI 与 MusicXML 不一致，以 MIDI 为准。MIDI 中没有的乐谱部分保持不变。
• 95% 的音符: MusicXML 中至少 95% 的音符必须出现在 MIDI 中。否则，编辑器会提示此 MusicXML 与此 MIDI 不匹配，并且不做任何更改。为获得最佳效果，请在最后一次修改之后，用同一个程序从同一份乐谱导出 MIDI 和 MusicXML（推荐 MuseScore）。反复记号、反复跳房子、D.C. 和 D.S. 会与 MIDI 中的处理方式一致。
• 保存的内容: MusicXML 文件不会保存到 .maestro 文件中：只保存改进后的 MIDI。它的名称和勾选标记会保留在 Setup 中，右上角的 MusicXML 图标表示该关卡使用过 MusicXML（将鼠标悬停在上面可查看匹配的音符比例）。
• 加载另一个 MIDI: 如果您在同一会话中加载另一个 MIDI，同一个 MusicXML 会自动再次应用到它上面。如果不再匹配，或者您重新打开了关卡，编辑器会提醒您重新添加。
• 撤销: 所有操作一步完成：一次 Ctrl+Z 即可撤销。

E. 屏幕视频（极光厅）

极光厅的舞台上方有一块电影银幕，因此您可以制作电影交响音乐会：视频在银幕上播放，并与您的乐团同步。选择此音乐厅后，此选项卡中会出现屏幕视频面板，并有一个视频图标提醒您此关卡始终会播放视频（如果您未选择，则播放默认视频）。

• 添加视频文件: 打开选择屏幕视频窗口。您可以输入文件名，使用查找视频从电脑中选择视频（会自动复制到视频文件夹），或使用打开视频文件夹打开 我的文档\Maestro\Videos。窗口会提示是否找到了视频。按 OK 确认，或按 Cancel 保留之前的选择。要恢复默认视频，请将字段留空并按 OK。
• 格式: .mp4、.webm 和 .mov。推荐：.mp4、H.264、1920x1080、30 fps、8-12 Mbps。
• 同步: 视频随音乐一起开始，并跟随 Play、Pause 和 Stop，因此始终与时间轴保持一致。
• 视频声音: 如果视频有声音，会像电影院一样从银幕两侧的两个扬声器播放。为获得最佳效果，请使用两条单声道音轨（左和右）；普通立体声音轨会从银幕中央播放。您可以在 Audio 选项卡中对其混音（见步骤 2）。

  重要: 视频不会保存在 .maestro 文件中。视频文件非常大，而且往往受版权保护，因此关卡只保存一个很小的引用（名称、文件大小和时长）。视频必须位于 我的文档\Maestro\Videos 中才能播放。如果找不到，Maestro 会在该文件夹中寻找最接近的视频；如果也没有，则播放默认视频，因此关卡始终可以正常运行。

重要提示：准备您的音频文件

Maestro Level Editor 自身不生成声音；它需要您提供音频文件。为此任务，您将需要使用外部音频编辑软件（被称为 DAW），如 Audacity（免费）、Reaper、FL Studio、Logic Pro 等。

主要有两种方法：

• 理想方法（分离轨道或 STEMS）: 最好的工作方式是为每种乐器或乐段配备单独的音频文件（例如 violins.mp3, flutes.mp3, percussion.mp3）。您可以通过以下方式创建这些文件：
  • 使用带有虚拟乐器音源库 (VST) 的 DAW。
  • 逐轨录制真实的交响乐团。此方法使您可以完全控制编辑器内的混音。
• 快速方法（立体声模式）: 如果您只有该作品的普通立体声录音（单个 .mp3 或 .ogg 文件），无需再将其拆分。在 Audio 选项卡中切换到立体声模式，然后将文件加载到立体声混音音轨中（见步骤 2）。乐手仍在 Setup 中选择：他们决定谁出现在舞台上，以及哪些声部参与游戏玩法。如果这份录音与 MIDI 的速度不一致，可以用 Tap Tempo 让一切与录音同步（见步骤 2）。
• 文件名: 如果每个文件名中都包含其乐器名称（例如 我的作品 - Violins I.mp3、我的作品 - Flute 2.wav），编辑器就可以通过 导入分轨 一次性加载所有文件（见步骤 2）。
• 预备小节（第 0 小节）: 在 Maestro 中，第 0 小节是指挥的预备小节：其中不应有任何声音，因为玩家要在乐团开始演奏之前打出这几拍。如果您的音乐从一开头就开始演奏，不用担心：编辑器可以为您添加这个空小节（见步骤 2）。

第 2 步：Audio 选项卡

选择乐器并准备好音频文件后，就可以导入它们了。

• Load Audio: 点击轨道上的 Open 按钮加载音频文件 (.mp3、.ogg 或 .wav)。加载后，您将看到其波形。您可以一次选择多个文件：它们会被混合到该轨道中（当一个声部有多个分谱时很有用，例如长笛 1 和长笛 2）。
• 导入分轨: Audio 选项卡顶部的 导入分轨 按钮可一次性加载所有声部的文件 (.mp3、.ogg 或 .wav)。将它们全部选中：编辑器会读取每个文件名，跳过所有文件共有的部分（通常是作品标题），并将每个文件放入其乐器的轨道中。它能识别多种语言的乐器名称、复数形式（例如 "Violoncellos"）以及带编号的声部。加载之前，会有一个窗口显示每个文件将放到哪里，已有音频的轨道会被标记为将被替换。当一个声部有多个文件时（例如 Horn 1、2、3 和 4），它们会被自动混合到该声部的轨道中；如果合在一起音量过大，音量会被稍微降低，以免失真。文件名中没有乐器名称的文件不会被加载：您可以用其轨道上的 Open 按钮手动加载它们。导入分轨无法用 Ctrl+Z 撤销。完成后，关卡助手会检查音频和 MIDI 是否对齐。
• 第 0 小节 (按钮): 此按钮位于 Audio 选项卡顶部，用于打开预备小节管理器。它会显示 MIDI 是否有预备小节、音乐从第几小节开始、有多少条音频轨道与 MIDI 对齐，并提供您需要的操作：
  • 添加预备小节: 如果音乐正好从第 0 小节开始，它会在开头添加一个空小节。MIDI、所有音频轨道、Gameplay 和 Animation 图标以及乐谱翻页都会一起向后移动一个小节，一次 Ctrl+Z 即可撤销。音频的移动无需重新编码，因此不会损失音质。您可以保留第一小节的 Tempo，也可以为新小节选择 BPM。屏幕视频（极光厅）不会被移动：编辑器会提醒您，以便您自行调整。如果音乐以弱起（弱拍起句）开始，助手会检测到，您可以通过 忽略 保持原样。
  • 同步音频: 将每条音频轨道与 MIDI 中其自身乐器的第一个音符进行比较。提前一个小节开始的轨道会被延后，包含两次预备小节的轨道会被提前。所有操作一次完成，不损失音质，并可用一次 Ctrl+Z 撤销。无法检查的轨道不会被更改，窗口会告诉您需要试听哪些轨道。
  • 对齐 MIDI: 如果所有音频都比 MIDI 晚整数个小节开始，则只移动 MIDI（以及图标）来与音频对齐。
  • 删除预备小节: 删除预备小节，但前提是它是用此工具添加的、此后您没有关闭过该关卡，并且其中没有任何声音。原始 MIDI 或音频自带的第 0 小节永远不会被删除：如果它不应该存在，请在您的记谱软件或音频文件中修正，然后重新导入。
• Tap Tempo（按钮）: 位于 Audio 选项卡顶部。当您把音频换成同一首曲子的另一份录音时使用它，例如立体声模式下的真实管弦乐团：真实录音从不会完全按照 MIDI 的速度演奏。跟着录音打拍子，您之前做好的一切（MIDI、玩法和动画图标以及乐谱翻页）都会对齐到录音上。音频本身不会改变。
  • 开始之前: 选择敲在每一拍还是每一小节（快速的曲子用每一小节更容易），以及第一次敲击的小节和拍（已默认设在 MIDI 音乐开始的位置）。勾选只修改一段可只修正某一段：前后的速度保持不变，音乐会提前几秒开始，方便您找到节奏。
  • 敲击: 按一次 TAP（或空格键）开始播放音乐，然后在每一拍上敲击，直到结尾。窗口会显示最后一次敲击的小节和拍、下一拍以及当前 BPM；如果某次敲击与前面差别很大（漏敲或多敲了一拍），会发出提醒。后退 2 小节（退格键）会删除最后两个小节，音乐退回几秒，方便您接着敲。Esc 暂停。您随时可以重新开始或取消。
  • 精度: 每次敲击都在您按下的那一刻精确测量，并扣除音箱或耳机的延迟。按一次校准（12 声咔嗒）可获得最佳精度；结果会保存在您的电脑上。有线耳机比无线耳机更精确。
  • 应用: 音频结束时（或按完成），会显示将要更改内容的摘要，并指出值得检查的敲击、可能不再需要的延长记号图标（真实录音本身已包含延长），以及音乐前的长时间静音。编辑器会像从 MIDI 导入一样创建 BPM 图标：敲击中的细小误差会被平滑，但真实的速度变化会保留。如果录音开始得太早、放不下第 0 小节，会在音频开头加入静音，音质不受影响。打开节拍器（M）后播放即可检查；一次 Ctrl+Z 可撤销全部操作。
• 立体声波形: 立体声混音音轨会显示两个声道：左声道在上，右声道在下。
• 混音: 每个轨道都有自己的 音量滑块（以 dB 为单位）、一个 Mute (M) 按钮，以及一个静音所有其他轨道的 Solo (S) 按钮。在顶部，您可以找到 Master Volume 控制。

  您也可以直接点击 dB 值（例如 "-3.5 dB"）输入精确的音量级别。此外，每个轨道都有一个 激活开关（复选框），可以在不改变音量设置的情况下完全启用或禁用其音频输出。

• 时间轴与控制: 使用 Play, Pause, 和 Stop 按钮来聆听您的混音。您可以拖动时间轴上的播放头在作品中导航。
• 节拍器: 激活节拍器以帮助您同步轨道。
• 音频模式（空间模式 / 立体声模式）: 顶部的两个开关用于选择提供音频的方式。空间模式（默认）为每件乐器显示一条音轨，适用于分轨文件（stems）。立体声模式会隐藏这些音轨，只显示一条用于完整立体声文件的立体声混音音轨。只有当前模式的音轨会随关卡保存。在另一模式中已加载的文件会在工作期间保留，以便您切换回去，但不会被保存。
• Maestro VR 中的立体声模式: 混音从舞台传出，玩家转头时声音仍留在舞台上。当某个声部错过进入时，混音中该声部所在的部分会被减弱，因此乐团仍会对玩家做出反应。若要获得最丰富的 3D 音效并完全控制每个声部，分轨（空间模式）仍是最佳选择。
• 视频音频音轨: 在有银幕的音乐厅（极光厅）中，两种模式下都会出现一条额外的视频音频音轨。由于声音来自视频，它没有 Open 按钮，但音量滑块、Mute 和 Solo 的用法与其他音轨相同。您的混音会随关卡保存。如果玩家没有您的视频，则使用默认视频（无声音）。

重要: 只有在 Setup 中至少选择了一种乐器后，Audio 选项卡才会被启用。在加载至少一个音频文件之前，Animation 和 Gameplay 选项卡将不会启用。

第 3 步：Animation 选项卡

为了让交响乐团对音乐做出视觉反应，您必须设置其动画。

• 轨道选择: 在列表中单击乐器名称以选择它。3D 视图将聚焦于它。

  3D 视图包含此选项卡专用的 4 个摄像机位置按钮，允许从不同角度查看所选音乐家。您还可以使用 Highlight Toggle 按钮（眼睛图标）将交响乐团的其余部分调暗，仅专注于选定的音乐家。在播放期间，每个轨道会实时显示 当前动画状态（例如 "Play", "Idle", "Ah"）和 播放速度。如果一位音乐家可以演奏多种乐器（如某些打击乐手），指示器 （例如 "1/3 Cymbal"） 将显示哪种乐器处于激活状态以及可用的数量。

• 轨道工具: 每个轨道都有简化编辑的按钮：
  • Copy (Ctrl+C): 从选定轨道复制所有动画图标。
  • Paste (Ctrl+V): 将复制的图标粘贴到选定轨道。编辑器只会粘贴与目标乐器兼容的图标。
  • Clear (Alt+Delete): 从选定轨道中删除所有图标。
  • Smart Animation: 强大的工具，分析乐器的音频并自动为您放置基本的动画图标。
  • Copy Range: 为选定的动画轨道打开按范围复制/粘贴面板（详见下文）。

了解动画图标

要制作动画，只需从左侧目录中拖动图标并将它们放到选定乐器轨道的 3 条轨道之一上。编辑器会自动阻止您将图标放置在不兼容的乐器上（例如在长笛上放置 "Pizzicato"）。每种图标颜色代表不同类型的动作：

• 蓝色图标（循环动画）: 这些是最常见的动画。它们代表一种连续状态，该状态保持活动，直到出现另一个蓝色或绿色图标。
  • 示例: Idle (休息), Ready (准备演奏), Play (演奏), Rest (长时间的休止), Pizz (弦乐的拨弦), Col Legno (用弓杆击弦), 或 Ah, Eh, Ee, Oh, Ooh (合唱团的元音口型)。
• 绿色图标（单次动作）: 这些是特定的、不循环的动作，会立即执行。执行后，音乐家将返回到先前的循环动画。
  • 示例: 让打击乐手敲击一次鼓的 Hit 图标。
• 橙色图标（配件 / 乐器交换）: 这些图标触发音乐家装备的变化。这可能是添加一个小配件（如 Mute 弱音器）或完全更换他们持有的乐器（例如打击乐手从铃鼓切换到响棒）。请注意，编辑器区分这两种类型；如果一个配件图标代表音乐家在特定音乐厅设置中没有的乐器，则不能将该图标放置在他们身上。
  • 示例: 在小号上放置 Mute，或者让打击乐手从铃鼓切换到响棒。
• 紫色图标（参数）: 这些图标不改变动画本身，而是修改其播放方式。
  • Animation Speed: 加快或减慢当前动画。您可以在将图标拖到时间轴 之前，直接在 目录内的输入字段 中设置所需的数值。
  • Animation Direction: 颠倒动画的播放方向。这对于为弦乐器创建逼真的上弓和下弓动作特别有用。

“Smart Animation” 功能

每个轨道都有一个带魔杖图标的按钮。这个强大的工具分析该乐器的音频，并自动为您放置 Idle, Ready, Play, 和 Rest（用于长时间静音）图标。这是为您的交响乐团制作动画的完美起点。

对于 合唱团声部（女高音、女低音、男高音、男低音），Smart Animation 更进一步：它使用内置的 元音识别系统，针对每种声音类型具有专用的频率配置。它不会使用通用的 "Play" 图标，而是根据音频的频谱分析自动放置 Ah, Eh, Ee, Oh, 或 Ooh 图标，创造出在整首作品中自然变化的逼真口部动作。

注意: 在立体声模式下没有每件乐器单独的音频，因此 Smart Animation 会分析完整混音：乐团发声时乐手演奏，静音时休息。此模式下无法使用合唱元音识别。

按范围复制/粘贴 (Animation)

每个动画轨道都有一个 Copy Range 按钮，可打开专用面板。此工具允许您：

• 定义一个 源范围（开始和结束小节编号）和一个 目标开始小节。
• 源范围内的所有兼容动画图标将被复制，并在目标范围内相应位置重新定位。
• 目标范围中已存在的图标将被自动替换。
• 该操作仅在当前选定的轨道内生效。
• 支持完整的撤销/重做 (Undo/Redo)。

MIDI 与自动化工具

如果您在 Setup 选项卡中加载了 MIDI 文件，每个乐器轨道都会解锁强大的新功能：

• MIDI 轨道下拉菜单: 从您的 MIDI 文件中选择哪个轨道对应于此特定乐器（例如，将 "Violin 1" MIDI 轨道分配给 "Violin I" 音乐家）。您的选择会保存在 .maestro 文件中。
• Smart MIDI (按钮): 根据乐器在 MIDI 文件中演奏音符的时间，自动在时间轴上放置 Play, Idle, 和 Ready 图标。这能在几秒钟内创建完美的动画基础。当 Sync MIDI 处于激活状态时，此按钮将被禁用。
• Sync MIDI (开关): 启用后，音乐家将进入“实时模式”。他们会忽略手动动画图标，转而以与 MIDI 数据精确同步的方式移动。其行为针对各个乐器家族量身定制：
  • 弦乐（小提琴、中提琴、大提琴、低音提琴）：具有基于力度 (velocity) 的速度的完美弓弦同步、在正确的琴弦编号上的手指放置、揉弦检测（包括空弦识别），以及通过 MIDI 音色更改 (patch changes) 自动将技巧切换到 Pizzicato 和 Col Legno。
  • 木管乐器（长笛、短笛、双簧管、英国管、单簧管、低音单簧管、巴松管、低音巴松管、所有萨克斯管）：手指放置与演奏的音符同步。
  • 铜管乐器（圆号、小号、长号、上低音号、大号）：手指放置与演奏的音符同步，另外通过 MIDI 音色更改为小号、长号、上低音号和大号自动进行 Mute 弱音器检测。
  • 打击乐器（定音鼓、小军鼓、大鼓、铙钹、辅助 A/B）：每个音符触发的击打动画，强度基于力度。定音鼓具有智能的交替手逻辑以及预测下一个鼓位置的自动前瞻功能。
  • 键盘打击乐器（木琴、钟琴）：琴槌会左右手交替敲击每个音符对应的正确音板，手臂自然跟随。音符之间，乐手会以 Ready 姿势等待。
    MIDI 同步数据在首次分析后会被缓存，因此开启和关闭 Sync 是很快的。每个轨道的 MIDI 轨道选择和同步状态都会保存在 .maestro 文件中，因此重新打开关卡时无需重新配置。
• 全部同步 MIDI (按钮): 在 Animation 时间轴顶部，同步 MIDI (n) 按钮会显示有多少位乐手已有 MIDI 轨道但尚未同步。按下它即可一次同步所有这些乐手；一次 Ctrl+Z 即可撤销。
• MIDI 信息面板: 当分配了 MIDI 轨道且时间轴正在播放时，会出现一个实时信息面板，显示：当前的 音符名称（例如 C4）和突出显示活动音符的微型 钢琴键盘 视觉效果、MIDI 编号（例如 60）、力度 (velocity)、演奏 状态（Playing/Idle/Ready）、当前 技巧（Normal, Pizzicato, Col Legno, Mute）以及 音色更改 (patch change) 信息。

MIDI 编辑器

在 MIDI 信息面板旁边有一个 MIDI 编辑器 选项卡。它以钢琴卷帘的形式显示 MIDI 的音符，让您无需使用任何其他程序，就能查看并更改每个段落的演奏方式。

• 查看: 在下拉菜单中选择 MIDI 轨道（它会跟随您在列表中选择的乐手），并使用缩放按钮。音符会按演奏法或打击乐器着色，标尺上会显示小节编号。
• 选择: 在音符上拖动即可选择一个段落（选区会吸附到十六分音符）。只需点击一下即可选择整个段落。右键点击可清除选区。
• 演奏法: 选中一些音符后，按下 普通、拨奏、弓杆奏 或 弱音器（弱音器仅适用于铜管乐器）。
• 打击乐: 在打击乐轨道上，从列表中选择一种乐器并按下 设置乐器，或将音符标记为 单击 或 滚奏（左右手交替）。
• 检测演奏法: 在整个 MIDI 中转换记谱软件写入的演奏法（使用通道或 "pizz." 等文字），与加载 MIDI 时的效果相同。
• 每次更改都可以用一次 Ctrl+Z 撤销，与 MIDI 同步的乐手会自动更新。这些更改会与 MIDI 一起保存在 .maestro 文件中。

第 4 步：Gameplay 选项卡

这里是您设计指挥体验的地方。从左侧目录拖动图标并将它们放到主时间轴的轨道上。

全局结构工具

在屏幕顶部，您将找到用于自动配置歌曲结构的工具：

• Smart MIDI Analysis: （需要已加载的 MIDI）从您的 MIDI 文件读取节拍图，并自动在时间轴上放置所有 BPM 和 Time Signature 更改，确保游戏与音乐完美同步。每次加载新的 MIDI 文件时，它也会自动运行。
• Reset Timing: 删除所有结构图标 (BPM/Time Signature) 以便从头开始。
• 智能力度: （需要已加载的 MIDI）此按钮位于 Dynamics 轨道旁边，它会读取 MIDI 中音符的强弱（音符力度 (velocity) 以及表情控制器 CC1、CC11 和 CC2），自动放置 pp、p、mf、f 和 ff 图标。如果 MIDI 没有力度变化（所有音符音量相同），或者音频未与 MIDI 对齐，它会提示您，而不会放置错误的图标。可以用 Ctrl+Z 撤销。如果 MIDI 已用 MusicXML 改进，则会改用乐谱中写明的力度（p、f、crescendo…）。
• 清除力度: 一次性删除所有力度图标。

Normal 视图与 Pro 视图

在 Gameplay 选项卡的右上角，您可以找到切换 Normal View 和 Pro View 的开关。这对应于 Maestro VR 中的两种不同游戏模式，允许您为每个难度级别定制指挥体验。时间轴是共享的，但您可以根据需要专门为每个视图放置图标（尽管通常使用 Normal View 图标就足够了）。

图标目录

• Tempo: 4 种基本的指挥手势（下、左、右、上）。它们是游戏玩法的核心。它们会自动吸附到最近的节拍上。
• BPM: 放置此图标以在特定点改变作品的 Tempo。您可以在将图标拖到时间轴 之前，直接在 目录内的输入字段 设置 BPM 值。
• Time Signature: 改变小节结构。放置时，您可以配置高级的指挥细节：
  • Pattern: 选择玩家应如何指挥（例如，快节奏作品选择 "二拍子 (In Two)" 或 "三拍子 (In Three)"）。
  • Grouping: 对于复杂拍号，请根据音乐乐句设置拍子的分组：5 拍用“3+2”或“2+3”，7 拍用“3+2+2”、“2+3+2”或“2+2+3”。每小节最多可有 9 拍；如果您的 MIDI 文件包含更大的拍号，Smart MIDI Analysis 会发出提示，方便您修改文件。
• Dynamics: 设置音乐强度 (pp, p, mf, f, ff)。
• Dynamics Changes: 可以从右边缘拉伸的可变持续时间图标 (渐强/渐弱)。
• Structure: 诸如 Fermatas (延长记号) 或作品的最终 End Bar (结束小节) 等特殊标记。注意：End Bar 线是唯一的 — 放置新线将自动删除以前的所有实例。
• Accents: 指示特定音乐重音的图标。
• Instruments: 指示哪些乐器家族应开始或停止演奏。这对于为交响乐团的特定部分提供 Cues (提示) 至关重要。

“Smart Tempo” 功能

在目录的 "Tempo" 部分中，您会找到两个带有手形图标的按钮，以及两个模式选择器（右手/左手）和两个清除按钮。首先，选择您想要的模式：

• 右手模式（默认）: 为右手指挥配置智能按钮。
• 左手模式: 为左手指挥配置智能按钮。

然后，使用 Smart Tempo 按钮：

• 右手按钮（图标根据模式变化）: 在右手模式下，为右手生成标准 Tempo 模式（下、左、右、上）。在左手模式下，为右手生成“动态” Tempo 模式（仅在 pp/ff 时有图标）。
• 左手按钮（图标根据模式变化）: 在右手模式下，为左手生成“动态” Tempo 模式（仅在 pp/ff 时有图标）。在左手模式下，为左手生成标准 Tempo 模式，翻转水平手势（Left 变为 Right，Right 变为 Left）。
• Clear Right Hand / Clear Left Hand: 从各自手的轨道上移除所有 Tempo 图标。在更改惯用手模式或拍号 (Time Signature) 后重新生成模式时非常有用。

按范围复制/粘贴工具 (Gameplay)

Gameplay 选项卡包含一个强大的 Copy/Paste by Range 工具，可通过工具栏按钮访问。此工具允许您：

• 定义一个 源范围（开始和结束小节编号）和一个将粘贴图标的 目标开始小节。
• 使用开关选择要包含在操作中的 轨道：Dynamics, 右手 (R/C/L) 和左手 (R/C/L)。
• 使用 Select All / Deselect All 按钮快速切换所有轨道。
• 目标范围中与粘贴内容重叠的图标将被自动替换 (Smart Replace)。
• 复制操作使用基于事件时间的亚节拍精度，因此即使在复杂的拍号中，图标也会放置在小节内完全相同的相对位置。
• 此工具绝对不会复制 BPM、Time Signature 和 End Bar 图标，因为它们是结构元素。
• 该操作支持完整的撤销/重做 (Undo/Redo)。

第 5 步：Preview 选项卡

最后一个选项卡向您显示您的关卡“卡片”在 Maestro VR 中的确切外观，包含您定义的封面图像、标题和描述。这是确保一切看起来完美的最后一步。就像在 Setup 选项卡中一样，在这里您同样拥有 多达 12 个摄像机视图 来实时观察完整的交响乐团。

从此选项卡，您还可以 将关卡上传到 Steam Workshop（参见第 5 节）。

4. 保存与分享您的关卡

保存

• 首次保存 (Save As): 当您第一次保存新关卡时，会出现一个“另存为”对话框，并根据您的作曲家、作品名称和副标题提供智能文件名建议（例如 "Beethoven_SymphNo5_AlleConBri"）。您可以在确认前编辑该名称。
• 快速保存: 关卡被保存过一次后，按下 Save (Ctrl+S) 将立即覆盖现有文件，不会有任何提示。
• 重命名: 如果您在首次保存后更改了作品名称、作曲家或副标题，编辑器将检测到名称更改并弹出一个对话框：Rename（重命名现有文件）、Save as New（保留原件并创建新副本）或 Cancel。
• 冲突解决: 如果所选的文件名已存在，编辑器会询问您是覆盖 (Overwrite) 现有文件、另存为新文件 (Save as New，它会自动分配一个数字后缀如 "_1", "_2")，还是取消 (Cancel)。
• 所有文件都保存在您的 我的文档\Maestro\Levels 文件夹中。

分享

非常简单！只需转到您的 我的文档\Maestro\Levels 文件夹，找到您的 .maestro 文件并将其分享即可。其他人只需使用其编辑器中的 Import 按钮，或将文件放入他们自己的 Levels 文件夹即可。

带视频的关卡: 视频不包含在 .maestro 文件中。请告诉对方要使用哪个视频以及从哪里获取（例如下载链接或原始来源），并让对方将其放入自己的 我的文档\Maestro\Videos 文件夹。对于 Steam Workshop 上的关卡，请把这些信息添加到关卡描述中。

5. Steam Workshop 集成

Maestro Level Editor 与 Steam Workshop 完全集成，使您可以轻松分享您的创作并发现社区创建的关卡。

浏览 Workshop

通过主菜单上的 Workshop 按钮访问 Workshop 浏览器。

• 搜索和过滤: 使用搜索栏按标题或创作者查找关卡。您还可以使用 标签下拉菜单 (Tag Dropdown) 按音乐时期进行过滤。
• 排序: 排序下拉菜单 (Sort Dropdown) 提供了多种对结果进行排序的方法，包括最多投票 (Most Voted)、最新 (Most Recent)、热门 (Trending)、最多订阅 (Most Subscribed)、您已安装的项目 (Installed)、您的项目 (My Items) 以及您的收藏 (My Favorites)。
• 分页: 使用 Previous 和 Next 按钮在结果页面之间导航。

与关卡互动

Workshop 浏览器中显示的每个关卡都会显示详细信息：

• 信息: 封面图像、标题、描述、作者、更新日期、发布日期和文件大小。
• 作者颜色: 如果作者是您 (青色)、Steam 好友 (绿色) 或游戏开发者 (金色)，则作者名称将以不同颜色着色。
• 评分: 通过星级和总评分数显示社区分数。
• 投票: 使用 Thumb Up/Down (赞/踩) 按钮投出您的选票。您的投票保存在本地并发送到 Steam。按钮将根据您的投票在视觉上更新。
• 收藏: 单击 Heart (心形) 按钮可将关卡添加至 Steam 收藏夹或从中删除。该状态也会保存在本地。
• 下载/安装状态:
  • Download 按钮: 如果关卡未安装则显示。点击以订阅并下载。
  • 进度条: 显示下载进度百分比。下载期间投票/收藏被禁用。
  • 已安装图标和 Uninstall 按钮: 成功下载并将关卡复制到您本地的 Levels 文件夹后显示。点击 Uninstall (卸载) 按钮将取消订阅 Steam 上的物品并删除本地副本。
• 文件备份: 如果下载的关卡与您 Levels 文件夹中已有关卡的文件名相同，您的本地文件不会丢失：它会被移动到 我的文档\Maestro\LevelBackups，并在文件名中加上日期和时间。

上传您的关卡

您可以直接从 Preview 选项卡上传您自己的关卡。

• 上传按钮 (Upload Button): 单击 "Upload to Steam Workshop" 按钮以打开上传对话框。
• 对话框字段:
  • 标题和描述 (Title & Description): 根据您关卡的 Setup 信息预先填充，但您可以在这里专门为 Workshop 编辑它们。字符限制适用。
  • 封面图像 (Cover Image): 显示将要使用的图像。
  • 修改说明 (Change Notes): 简要描述此版本的新增内容或修复内容（更新时需要）。新项目的默认值为 "Initial upload"。
  • 可见性 (Visibility): 选择谁可以看到您的项目（Public, Friends Only, Private）。
  • YouTube 链接: （可选）添加展示您关卡的视频链接。
  • 音乐时期标签 (Musical Period Tag): 根据您在 Setup 选项卡中的选择自动设置。此标签可帮助玩家在 Workshop 浏览器中通过过滤找到您的关卡。
  • 作为新项目上传 (Upload as New Item): 如果您想强制将其作为全新的 Workshop 项目上传，即使该关卡以前曾被上传过（这对于大型修订或重新发布很有用），请选中此框。如果未选中，编辑器将在具有已保存的 Workshop ID 时更新现有项目，否则它将创建一个新项目。
• 上传过程: 点击 "Upload" 开始该过程。进度面板将显示状态 (Preparing, Uploading Content, Uploading Preview, Committing) 和进度条。"OK" 按钮会在完成或出错时出现。
• Workshop ID: 当您首次上传关卡（并且未选中 "Upload as New"）时，Steam 分配的唯一 Workshop ID 将自动保存在您的 .maestro 文件中。随后的上传（不选中该框）将更新该特定项目。

6. 键盘快捷键

主菜单

• Ctrl + N: 新建关卡
• Ctrl + O: 打开选定关卡
• Ctrl + I: 导入关卡
• Delete: 删除选定的关卡
• F5: 刷新关卡列表
• Ctrl + Shift + Delete: 清除缓存

在关卡编辑器中

• F1 至 F5: 在选项卡之间切换（Setup, Audio, Animation, Gameplay, Preview）。
• 1 至 0, -, =: 选择摄像机视图（上下文相关，取决于选项卡，最多 12 个视图：Setup[1-8], Animation[1-4], Gameplay[1-2], Preview[1-12]）。
• Ctrl + S: 保存。
• Ctrl + Z: 撤销。
• Ctrl + Y: 重做。
• 空格键 (Spacebar): 播放 / 暂停（在带有时间轴的选项卡中）。
• Ctrl + .: 停止播放。
• M: 切换节拍器。
• Delete: 删除选定的 Gameplay 或 Animation 图标。
• Ctrl + C / Ctrl + V: 在选定的动画轨道 (Animation Track) 上复制 / 粘贴图标。
• Alt + Delete: 清除选定的动画轨道 (Animation Track) 上的所有图标。
• 空格 / 退格 / Esc: 在 Tap Tempo 窗口中：敲击 / 后退 2 小节 / 暂停。