iOS MIDI播放器调用setPreload(true)触发断言失败致卡顿求助

一、先搞定断言失败的问题 #

你碰到的ASSERTION FAILED: Preroll mode set during render错误，核心原因很明确——你在音频渲染的实时线程里尝试修改预加载模式了。音频单元的渲染回调是实时优先级线程，任何阻塞、或者不符合实时要求的操作（比如设置属性、解析预加载内容）都绝对不能在这里执行。

你得把所有和预加载相关的配置，包括设置kAUMIDISynthProperty_EnablePreload属性、解析SMF的操作，都挪到主线程或者专门的准备线程里完成，绝对不能碰渲染回调的代码块。

二、关于音色加载的疑问解答 #

你说不开kAUMIDISynthProperty_EnablePreload时打击乐能发声，其他乐器没声音，这完全符合GM（通用MIDI）的标准规则：

• 通道10是默认的打击乐专属通道，iOS上的大部分MIDI合成器都会自动把这个通道映射到打击乐Bank，哪怕没有额外的音色设置消息，也能触发声音。
• 而钢琴、吉他这类乐器所在的其他通道，需要SMF文件里包含对应的Program Change（音色变更）消息，同时合成器得加载对应的音色样本。预加载的作用就是提前解析SMF里的这些Program Change、Bank Select等消息，让合成器预先把需要的音色资源加载好，避免播放时因为实时加载导致无声或者卡顿。

所以AVAudioUnitMIDISynth确实需要通过kAUMIDISynthProperty_EnablePreload来提前分析SMF中的轨道与音色对应关系，确保所有需要的音色都被预先加载到位。

三、正确的SMF预加载完整步骤 #

补全你提到的流程，完整的操作步骤应该是这样的：

1. 在非渲染线程开启预加载模式
   先获取AVAudioUnitMIDISynth对应的AudioUnit实例，然后设置kAUMIDISynthProperty_EnablePreload属性为1：

AudioUnit midiSynthUnit = self.midiSynth.audioUnit;
UInt32 enablePreload = 1;
OSStatus status = AudioUnitSetProperty(
    midiSynthUnit,
    kAUMIDISynthProperty_EnablePreload,
    kAudioUnitScope_Global,
    0,
    &enablePreload,
    sizeof(enablePreload)
);
// 记得检查status是否为noErr，确保设置成功

2. 预加载SMF文件内容
   这一步要让AVAudioSequencer把SMF里的所有MIDI事件（包括Program Change、Bank Select等）发送给AVAudioUnitMIDISynth，但不实际播放。具体操作：

• 先把SMF文件加载到AVAudioSequencer中
• 调用sequencer.preroll(at: nil)（Swift）或者[sequencer prerollAtTime:nil error:nil]（Objective-C），这个方法会让sequencer发送所有播放前需要的MIDI设置消息给合成器，同时不会触发播放
• 等待preroll完成（可以通过回调或者状态检查，确保所有音色都加载完毕）

3. 关闭预加载模式
   同样在非渲染线程中，把kAUMIDISynthProperty_EnablePreload属性设置为0：

UInt32 enablePreload = 0;
OSStatus status = AudioUnitSetProperty(
    midiSynthUnit,
    kAUMIDISynthProperty_EnablePreload,
    kAudioUnitScope_Global,
    0,
    &enablePreload,
    sizeof(enablePreload)
);

4. 启动AVAudioSequencer播放
   现在就可以安全调用sequencer.play()来播放SMF文件了，此时所有需要的音色都已经预加载完成，不会出现无声或者卡顿的问题。

额外注意事项 #

• 确保你的AVAudioSession已经正确配置（比如设置为播放类别，激活会话）
• 如果SMF文件中包含Bank Select消息，预加载过程也会处理这些消息，确保合成器加载正确的音色库
• 预加载过程可能需要一点时间（取决于SMF的复杂度和音色大小），建议在预加载时显示加载指示器，提升用户体验

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