📖 概述
ScoreFlow 提供兩種主要的交互模式，以滿足不同的使用場景：
- 閱讀模式 (Reader Mode)：用於演奏時快速翻頁
- 編輯模式 (Editing Mode)：用於添加註釋、圖章和編輯樂譜
📄 Page 顯示模式
Toolbar 的 Page 顯示模式會影響樂譜頁面的排列方式、翻頁方式和預設縮放。
單頁 (Single Page)
一次顯示一頁，預設使用「符合頁面」，頁面會盡量完整放入畫面。適合演奏時需要穩定翻頁、避免頁面上下移動的情境。
單頁滾動 (Single Page Scroll)
一次仍以單頁為單位翻頁，預設使用「符合高度」，讓整頁高度完整顯示，避免頁面底部被裁切。單點頁面時會直接進入上一頁或下一頁。適合想保留一頁一頁翻頁，又希望頁面不需要先捲完才翻頁的情境。
連續滾動 (Continuous Scroll)
多頁會垂直接在一起，像長卷一樣連續往下捲動，預設使用「符合寬度」。上下滑動可自由瀏覽內容；需要換頁時，請使用單點換頁或頁面控制按鈕。適合練習、瀏覽或需要跨頁順著看下去的情境。
雙頁 (Double Page)
同時顯示左右兩頁，接近攤開紙本樂譜的閱讀方式。適合橫向螢幕或需要看見前後樂句關係的情境。
浮動換頁面板
如果希望更容易操作頁面，可以到 Settings → 浮動換頁按鈕 開啟面板，並在「浮動換頁按鈕位置」選擇顯示於左側或右側。
面板由上到下包含上一頁箭頭和下一頁箭頭：
- 短按上方箭頭 → 上一頁
- 短按下方箭頭 → 下一頁
- 長按上方箭頭 → 跳到第一頁
- 長按下方箭頭 → 跳到最後一頁
面板本身需要先長按約 0.35 秒，才可以拖曳到其他位置。
點擊螢幕最底部的頁碼提示區，會顯示目前頁碼以及可直接操作的 Page Up／Page Down 按鈕。
🔄 模式切換
按下 toolbar 中的 Reader Mode 按鈕來切換模式：
最適合在舞台上演奏時使用。簡化交互，專注於翻頁和演奏。
最適合課堂或練習時使用。可以添加筆記、圖章和其他註釋。
🎵 閱讀模式 (Reader Mode: ON)
在閱讀模式下，ScoreFlow 優化了用於演奏的交互。所有編輯工具都被停用，讓您可以專心演奏。
✋ 手勢操作
-
👆 單指點擊 - 快速翻頁• 點擊左側 30% 區域 → 上一頁
• 點擊右側 70% 區域 → 下一頁 -
🔄 雙指捏合 - 縮放向內捏合縮小，向外張開放大樂譜
-
👉 單指滑動 - 捲動在放大的樂譜中滑動以查看不同部分
✏️ 編輯模式 (Reader Mode: OFF)
在編輯模式下，單指用於選取和編輯頁面物體，雙指手勢用於翻頁。
✋ 手勢操作
-
👆 單指點擊 - 選取物體• 點擊樂譜上的圖章 → 選中並編輯
• 點擊空白區域 → 取消選擇 -
👉 單指拖曳 - 移動或繪畫• 拖曳選中的圖章以移動位置
• 如果啟用繪畫工具，拖曳可進行繪畫 -
👈👉 雙指輕掃 - 翻頁• 向左輕掃 → 下一頁
• 向右輕掃 → 上一頁 -
🔄 雙指捏合 - 縮放向內捏合縮小，向外張開放大樂譜
📊 交互對比表
| 操作 | 閱讀模式 | 編輯模式 |
|---|---|---|
| 單指點擊 | 快速翻頁（區域分割） | 選取圖章或物體 |
| 單指拖曳 | 捲動樂譜 | 移動圖章或繪畫 |
| 雙指輕掃 | 禁用 | 翻頁 |
| 雙指捏合 | 縮放樂譜 | 縮放樂譜 |
| 雙指點擊 | 重置為適應頁面 | 重置為適應頁面 |
🎯 典型使用場景
場景 1：舞台演奏
場景 2：課堂教學
場景 3：樂譜編輯
💡 重要提示
🎼 在閱讀模式下
• 所有編輯工具都被自動停用
• 這確保了演奏時不會意外觸發編輯
• 編輯模式的雙指輕掃會被停用；閱讀模式可使用單指點擊翻頁，連續模式請使用單點或頁面控制按鈕換頁
✏️ 在編輯模式下
• 單指點擊用於選取物體，而不是翻頁
• 必須使用雙指輕掃來翻頁
• 啟用編輯工具時，單指操作被路由到畫布
🔄 模式切換建議
• 演奏前切換到閱讀模式
• 編輯或添加註釋時切換到編輯模式
• Reader Mode 按鈕位於 toolbar 頂部，易於快速切換
❓ 常見問題
Q: 為什麼我在編輯模式下單指點擊無法翻頁？
A: 這是設計所致。在編輯模式下，單指被保留用於選取圖章和物體。請使用雙指輕掃來翻頁。這可以防止在編輯時意外翻頁。
Q: 我可以在演奏時禁用雙指輕掃嗎？
A: 是的！進入閱讀模式時，雙指輕掃會被自動禁用。只有單指點擊可用於翻頁。
Q: 雙指點擊做什麼用？
A: 雙指點擊會重置縮放級別並將樂譜調整為適應頁面大小。在您放大檢查細節後，此操作很有用。
Q: 如何快速在模式之間切換？
A: 按下 toolbar 頂部的 Reader Mode 按鈕。它會立即切換所有交互行為。
⚙️ 技術細節
以下是交互系統的技術實現方式：
viewModel.isReaderMode = true
- 單指 Tap 啟用
- 雙指 Swipe 禁用
- 所有編輯工具停用
viewModel.isReaderMode = false
- 單指 Tap 禁用
- 雙指 Swipe 啟用
- 編輯工具可用
🎓 總結
快速參考
演奏時： 啟用 Reader Mode → 使用單指翻頁 → 專注演奏
編輯時： 關閉 Reader Mode → 使用單指選取 → 雙指輕掃翻頁 → 添加註釋
ScoreFlow 的交互設計遵循「情景感知」原則——系統根據您的工作模式自動調整觸摸行為，讓您無論是在舞台上演奏還是在教室裡編輯，都能獲得最佳體驗。