用戶手冊：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 小節 / 暫停。