feat: 导入谱面时，高级选项中增加“MP3兼容模式（忽略Gapless）”

Starrah · Starrah · commit 1c1957dfbe6b · 2026-03-11T16:17:19.000+08:00
diff --git a/MaiChartManager.CLI/Commands/MakeAcbCommand.cs b/MaiChartManager.CLI/Commands/MakeAcbCommand.cs
@@ -22,6 +22,11 @@ public class Settings : CommandSettings
         [Description("音频填充（秒），正数为前置静音，负数为裁剪开头")]
         [DefaultValue(0f)]
         public float Padding { get; set; }
+        
+        [CommandOption("--ignoreGapless")]
+        [Description("使用MP3兼容模式（忽略音频中的Gapless信息）。如果你使用某些版本的Visual Maimai等制谱器制谱，然后发现导入的谱面有对音问题的话，可以尝试开启此项")]
+        [DefaultValue(false)]
+        public bool IgnoreGapless { get; set; }
 
         public override ValidationResult Validate()
         {
@@ -87,7 +92,8 @@ await Task.Run(() =>
                     Audio.ConvertToMai(
                         srcPath: source,
                         savePath: output,
-                        padding: settings.Padding
+                        padding: settings.Padding,
+                        forceUseNAudio: settings.IgnoreGapless
                     );
                 });
             });
@@ -131,7 +137,8 @@ await Task.Run(() =>
                             Audio.ConvertToMai(
                                 srcPath: source,
                                 savePath: output,
-                                padding: settings.Padding
+                                padding: settings.Padding,
+                                forceUseNAudio: settings.IgnoreGapless
                             );
                         });
                         doneCount++;
diff --git a/MaiChartManager/Controllers/Music/CueConvertController.cs b/MaiChartManager/Controllers/Music/CueConvertController.cs
@@ -24,7 +24,7 @@ public async Task<ActionResult> GetMusicWav(int id, string assetDir)
 
     [HttpPut]
     [DisableRequestSizeLimit]
-    public void SetAudio(int id, [FromForm] float padding, IFormFile file, IFormFile? awb, IFormFile? preview, string assetDir)
+    public void SetAudio(int id, [FromForm] float padding, IFormFile file, IFormFile? awb, IFormFile? preview, string assetDir, [FromForm] bool ignoreGapless = false)
     {
         id %= 10000;
         var targetAcbPath = Path.Combine(StaticSettings.StreamingAssets, assetDir, $@"SoundData\music{id:000000}.acb");
@@ -41,7 +41,7 @@ public void SetAudio(int id, [FromForm] float padding, IFormFile file, IFormFile
         }
         else
         {
-            Audio.ConvertToMai(file.FileName, targetAcbPath, padding, file.OpenReadStream(), preview?.FileName, preview?.OpenReadStream());
+            Audio.ConvertToMai(file.FileName, targetAcbPath, padding, file.OpenReadStream(), preview?.FileName, preview?.OpenReadStream(), forceUseNAudio: ignoreGapless);
         }
 
         StaticSettings.AcbAwb[$"music{id:000000}.acb"] = targetAcbPath;
diff --git a/MaiChartManager/Controllers/Tools/AudioConvertToolController.cs b/MaiChartManager/Controllers/Tools/AudioConvertToolController.cs
@@ -87,7 +87,7 @@ private IActionResult ConvertAcbAwbToMp3(string inputFile, string directory, str
     /// <summary>
     /// 将音频文件转换为 ACB/AWB
     /// </summary>
-    private IActionResult ConvertToAcbAwb(string inputFile, string directory, string fileNameWithoutExt, string extension)
+    private IActionResult ConvertToAcbAwb(string inputFile, string directory, string fileNameWithoutExt, string extension, bool ignoreGapless = false)
     {
         string tempAudioFile = null;
 
@@ -108,7 +108,7 @@ private IActionResult ConvertToAcbAwb(string inputFile, string directory, string
             string awbPath = Path.Combine(directory, fileNameWithoutExt + ".awb");
 
             // 执行转换
-            Audio.ConvertToMai(actualInputFile, acbPath);
+            Audio.ConvertToMai(actualInputFile, acbPath, forceUseNAudio: ignoreGapless);
 
             return Ok(new { message = Locale.ConvertSuccess, acbPath = acbPath, awbPath = awbPath });
         }
diff --git a/MaiChartManager/Front/src/client/apiGen.ts b/MaiChartManager/Front/src/client/apiGen.ts
@@ -1282,6 +1282,8 @@ export class Api<
         awb?: File;
         /** @format binary */
         preview?: File;
+        /** @default false */
+        ignoreGapless?: boolean;
       },
       params: RequestParams = {},
     ) =>
diff --git a/MaiChartManager/Front/src/locales/en.yaml b/MaiChartManager/Front/src/locales/en.yaml
@@ -249,6 +249,8 @@ chart:
         present)
 
         May cause first note to appear at odd timing, e.g. immediately at start
+      ignoreGapless: MP3 compatibility mode (ignore Gapless)
+      ignoreGaplessTip: If the chart was made with some specific chart editors, such as certain versions of Visual Maimai, and the imported chart has timing issues, you can try enabling this option.
       codecForceH264: H264
       codecForceVP9: VP9 USM
     assignId: Assign ID for new imported songs
diff --git a/MaiChartManager/Front/src/locales/zh-TW.yaml b/MaiChartManager/Front/src/locales/zh-TW.yaml
@@ -231,6 +231,8 @@ chart:
       shiftNoMoveDesc: |-
         完全不修改譜面，從音訊中刪除 &first 的長度（如果有）
         可能會導致第一個音符出現的時機比較奇怪，比如說剛開始就有音符
+      ignoreGapless: MP3 相容模式（忽略 Gapless）
+      ignoreGaplessTip: 如果你使用某些版本的 Visual Maimai 等製譜器製譜，然後發現匯入的譜面有對音問題的話，可以嘗試開啟此項進行匯入。
       codecForceH264: H264
       codecForceVP9: VP9 USM
     assignId: 為新匯入的歌曲指定 ID
diff --git a/MaiChartManager/Front/src/locales/zh.yaml b/MaiChartManager/Front/src/locales/zh.yaml
@@ -231,6 +231,8 @@ chart:
       shiftNoMoveDesc: |-
         完全不修改谱面，从音频中删除 &first 的长度（如果有）
         可能会导致第一个音符出现的时机比较奇怪，比如说刚开始就有音符
+      ignoreGapless: MP3兼容模式（忽略Gapless）
+      ignoreGaplessTip: 如果你使用某些版本的Visual Maimai等制谱器制谱，然后发现导入的谱面有对音问题的话，可以尝试开启此项进行导入。
       codecForceH264: H264
       codecForceVP9: VP9 USM
     assignId: 为新导入的歌曲指定 ID
diff --git a/MaiChartManager/Front/src/views/Charts/ImportCreateChartButton/ImportChartButton/ErrorDisplayIdInput.tsx b/MaiChartManager/Front/src/views/Charts/ImportCreateChartButton/ImportChartButton/ErrorDisplayIdInput.tsx
@@ -1,5 +1,5 @@
 import { computed, defineComponent, effect, PropType, watch } from "vue";
-import { Button, CheckBox, Modal, NumberInput, Section } from "@munet/ui";
+import { Button, CheckBox, Modal, NumberInput, Popover, Section } from "@munet/ui";
 import { ImportChartMessage, MessageLevel, ShiftMethod } from "@/client/apiGen";
 import { ImportChartMessageEx, ImportMeta, SavedOptions, TempOptions } from "./types";
 import noJacket from '@/assets/noJacket.webp';
@@ -70,6 +70,15 @@ export default defineComponent({
             </CheckBox>
             <Section title={t('chart.import.option.advancedOptions')}>
                 <ShiftModeSelector tempOptions={props.tempOptions}></ShiftModeSelector>
+                <div class="flex items-center gap-1" style="margin-top: 0.25rem">
+                  <CheckBox v-model:value={props.tempOptions.ignoreGapless}>{t('chart.import.option.ignoreGapless')}</CheckBox>
+                  <Popover trigger="hover">
+                    {{
+                      trigger: () => <div class="i-material-symbols:info-outline-rounded op-50"/>,
+                      default: () => <div class="max-w-60">{t('chart.import.option.ignoreGaplessTip')}</div>
+                    }}
+                  </Popover>
+                </div>
             </Section>
         </>}
       </div>,
diff --git a/MaiChartManager/Front/src/views/Charts/ImportCreateChartButton/ImportChartButton/index.tsx b/MaiChartManager/Front/src/views/Charts/ImportCreateChartButton/ImportChartButton/index.tsx
@@ -168,7 +168,7 @@ export default defineComponent({
         // 音频上应该应用的延迟audioPadding = 谱面上应用的延迟chartPadding - &first
         let audioPadding = chartPadding - music.first;
 
-        await api.SetAudio(music.id, selectedADir.value, { file: music.track, padding: audioPadding });
+        await api.SetAudio(music.id, selectedADir.value, { file: music.track, padding: audioPadding, ignoreGapless: !!tempOptions.value.ignoreGapless });
 
         if (music.movie && !tempOptions.value.disableBga) {
           currentMovieProgress.value = 0;
diff --git a/MaiChartManager/Front/src/views/Charts/ImportCreateChartButton/ImportChartButton/types.ts b/MaiChartManager/Front/src/views/Charts/ImportCreateChartButton/ImportChartButton/types.ts
@@ -53,5 +53,6 @@ export type TempOptions = {
   shiftLocked?: boolean,
   ignoreLevel?: boolean,
   disableBga?: boolean,
+  ignoreGapless?: boolean,
 };
 export type SavedOptions = typeof defaultSavedOptions;
diff --git a/MaiChartManager/Utils/Audio.cs b/MaiChartManager/Utils/Audio.cs
@@ -9,10 +9,10 @@ namespace MaiChartManager.Utils;
 
 public static class Audio
 {
-    public static void ConvertToMai(string srcPath, string savePath, float padding = 0, Stream? src = null, string? previewFilename = null, Stream? preview = null)
+    public static void ConvertToMai(string srcPath, string savePath, float padding = 0, Stream? src = null, string? previewFilename = null, Stream? preview = null, bool forceUseNAudio = false)
     {
         var wrapper = new ACB_Wrapper(ACB_File.Load(File.ReadAllBytes(Path.Combine(StaticSettings.exeDir, previewFilename is null ? "nopreview.acb" : "template.acb")), null));
-        var trackBytes = LoadAndConvertFile(srcPath, FileType.Hca, false, 9170825592834449000, padding, src);
+        var trackBytes = LoadAndConvertFile(srcPath, FileType.Hca, false, 9170825592834449000, padding, src, forceUseNAudio);
 
         wrapper.Cues[0].AddTrackToCue(trackBytes, true, false, EncodeType.HCA);
         if (previewFilename is not null)
@@ -25,7 +25,7 @@ public static void ConvertToMai(string srcPath, string savePath, float padding =
     }
 
     // 不要 byte[] 转 memory stream 倒来倒去，直接传入 stream
-    public static byte[] LoadAndConvertFile(string path, FileType convertToType, bool loop, ulong encrpytionKey = 0, float padding = 0, Stream? src = null)
+    public static byte[] LoadAndConvertFile(string path, FileType convertToType, bool loop, ulong encrpytionKey = 0, float padding = 0, Stream? src = null, bool forceUseNAudio = false)
     {
         using var read = src ?? File.OpenRead(path);
         switch (Path.GetExtension(path).ToLowerInvariant())
@@ -35,7 +35,7 @@ public static byte[] LoadAndConvertFile(string path, FileType convertToType, boo
             case ".ogg":
             case ".wma":
             case ".aac":
-                return ConvertFile(ConvertToWav(read, Path.GetExtension(path).Equals(".ogg", StringComparison.InvariantCultureIgnoreCase), padding), FileType.Wave, convertToType, loop, encrpytionKey);
+                return ConvertFile(ConvertToWav(read, Path.GetExtension(path).Equals(".ogg", StringComparison.InvariantCultureIgnoreCase), padding, forceUseNAudio), FileType.Wave, convertToType, loop, encrpytionKey);
             case ".hca":
                 return ConvertFile(read, FileType.Hca, convertToType, loop, encrpytionKey);
             case ".adx":
@@ -58,14 +58,14 @@ public static byte[] LoadAndConvertFile(string path, FileType convertToType, boo
         throw new InvalidDataException($"Filetype of \"{path}\" is not supported.");
     }
 
-    public static Stream ConvertToWav(Stream src, bool isOgg, float padding = 0)
+    public static Stream ConvertToWav(Stream src, bool isOgg, float padding = 0, bool forceUseNAudio = false)
     {
         using WaveStream reader = isOgg
             ? new NAudio.Vorbis.VorbisWaveReader(src, true)
-            // 如果直接用StreamMediaFoundationReader的话，mp3转wav的过程会有问题，详见https://github.com/MuNET-OSS/MaiChartManager/issues/40#issuecomment-4029798667。
-            // 因此，将使用ffmpeg完成从mp3到wav的转换；但由于需要进行padding，所以还是得再以sample的形式读出来然后重新保存。
-            // PS：使用NAudio的WaveFileReader来直接处理wav文件是没有问题的，因为wav本身是一种基于sample的无损采样格式，没有encdelay之类的问题。只要确保不要使用NAudio进行MP3编解码即可。
-            : new WaveFileReader(ConvertMp3ToWavViaFfmpeg(src));
+            : (forceUseNAudio
+                ? new StreamMediaFoundationReader(src) // NAudio不支持MP3 Gapless，所以作为一种“兼容模式”提供
+                : new WaveFileReader(ConvertMp3ToWavViaFfmpeg(src))); // 默认情况下，优先使用ffmpeg
+           // 关于上述MP3 Gapless问题的影响等具体讨论，详见 https://github.com/MuNET-OSS/MaiChartManager/issues/40
         var sample = reader.ToSampleProvider();
 
         switch (padding)

Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,7 @@ public async Task<ActionResult> GetMusicWav(int id, string assetDir)`
`24`	`24`
`25`	`25`	`[HttpPut]`
`26`	`26`	`[DisableRequestSizeLimit]`
`27`		`- public void SetAudio(int id, [FromForm] float padding, IFormFile file, IFormFile? awb, IFormFile? preview, string assetDir)`
	`27`	`+ public void SetAudio(int id, [FromForm] float padding, IFormFile file, IFormFile? awb, IFormFile? preview, string assetDir, [FromForm] bool ignoreGapless = false)`
`28`	`28`	`{`
`29`	`29`	`id %= 10000;`
`30`	`30`	`var targetAcbPath = Path.Combine(StaticSettings.StreamingAssets, assetDir, $@"SoundData\music{id:000000}.acb");`
`@@ -41,7 +41,7 @@ public void SetAudio(int id, [FromForm] float padding, IFormFile file, IFormFile`
`41`	`41`	`}`
`42`	`42`	`else`
`43`	`43`	`{`
`44`		`- Audio.ConvertToMai(file.FileName, targetAcbPath, padding, file.OpenReadStream(), preview?.FileName, preview?.OpenReadStream());`
	`44`	`+ Audio.ConvertToMai(file.FileName, targetAcbPath, padding, file.OpenReadStream(), preview?.FileName, preview?.OpenReadStream(), forceUseNAudio: ignoreGapless);`
`45`	`45`	`}`
`46`	`46`
`47`	`47`	`StaticSettings.AcbAwb[$"music{id:000000}.acb"] = targetAcbPath;`
Original file line number	Diff line number	Diff line change
`@@ -87,7 +87,7 @@ private IActionResult ConvertAcbAwbToMp3(string inputFile, string directory, str`
`87`	`87`	`/// <summary>`
`88`	`88`	`/// 将音频文件转换为 ACB/AWB`
`89`	`89`	`/// </summary>`
`90`		`- private IActionResult ConvertToAcbAwb(string inputFile, string directory, string fileNameWithoutExt, string extension)`
	`90`	`+ private IActionResult ConvertToAcbAwb(string inputFile, string directory, string fileNameWithoutExt, string extension, bool ignoreGapless = false)`
`91`	`91`	`{`
`92`	`92`	`string tempAudioFile = null;`
`93`	`93`
`@@ -108,7 +108,7 @@ private IActionResult ConvertToAcbAwb(string inputFile, string directory, string`
`108`	`108`	`string awbPath = Path.Combine(directory, fileNameWithoutExt + ".awb");`
`109`	`109`
`110`	`110`	`// 执行转换`
`111`		`- Audio.ConvertToMai(actualInputFile, acbPath);`
	`111`	`+ Audio.ConvertToMai(actualInputFile, acbPath, forceUseNAudio: ignoreGapless);`
`112`	`112`
`113`	`113`	`return Ok(new { message = Locale.ConvertSuccess, acbPath = acbPath, awbPath = awbPath });`
`114`	`114`	`}`