AVAudioSequencer播放AVAudioUnitSampler时MIDI音符截断解决方法

这个音符被异常截断、播放效果退化为单音的问题，均为API配置疏漏导致，按以下优先级排查即可解决：

1. 修正AVAudioUnitSampler的复音与偷音配置 #

80%以上的同类问题都是这两个参数配置错误导致的：初始化Sampler时不要依赖默认参数，必须显式指定最大复音数、关闭不必要的偷音逻辑：

AVAudioUnitSampler *drumSampler = [[AVAudioUnitSampler alloc] init];
// 打击乐场景建议将最大复音数设为64及以上，保证镲片等长衰音可以同时叠加发声
drumSampler.maximumPolyphony = 64;
// 关闭语音偷取逻辑，避免新音符触发时强制切断正在发声的旧音符
drumSampler.voiceStealingEnabled = NO;

如果复音数被误设为1，或者开启偷音逻辑但复音数预留不足，就会出现新音符一响、旧音符立刻被切断的单音效果。

2. 修正MusicSequence的轨道通道路由 #

使用旧版MusicSequence API加载MIDI文件时，如果不显式指定每个轨道的MIDI通道，所有轨道的MIDI事件会被默认路由到同一个通道，触发通道级的音符冲突：

• 遍历所有MusicTrack，按轨道属性显式绑定对应MIDI通道
• 碎音镲属于打击乐声部，必须固定绑定到MIDI通道10（代码中通道索引从0开始计数，对应值为9），不能和其他旋律音轨共用通道

UInt32 trackCount = 0;
MusicSequenceGetTrackCount(yourSequence, &trackCount);
for (UInt32 trackIndex = 0; trackIndex < trackCount; trackIndex++) {
    MusicTrack currentTrack = NULL;
    MusicSequenceGetIndTrack(yourSequence, trackIndex, &currentTrack);
    // 按轨道实际用途赋值通道，打击乐轨道固定传9，其余旋律轨按对应音色赋值0-8/10-15
    UInt8 targetChannel = 9;
    MusicTrackSetProperty(currentTrack, kSequenceTrackProperty_Channel, &targetChannel, sizeof(targetChannel));
}

3. 关闭Sequencer的自动事件对齐 #

AVAudioSequencer默认开启MIDI事件自动量化修正，部分时间戳不规范的MIDI文件（尤其是第三方导出的电鼓分轨），会被系统错误将长音的Note Off事件对齐到下一个Note On的时间点，直接截断长音。
加载完MIDI后遍历所有Sequencer轨道，关闭自动量化与自动修正逻辑，保留原始MIDI的事件时间戳即可。

4. 过滤异常MIDI控制事件 #

部分制作不规范的MIDI文件，会在每个Note On事件前错误插入All Notes Off（CC123）、All Sound Off（CC120）控制信号，这类信号会直接切断所有正在发声的音符。可以在加载MIDI后遍历轨道事件，过滤掉非必要的全局断音控制事件。

验证技巧：将出问题的MIDI文件导入GarageBand等专业DAW播放，如果没有出现截断问题，即可排除MIDI文件本身的事件错误，优先排查前三项配置问题。

内容的提问来源于stack exchange，提问作者jaybers