AudioKit采样器同MIDI音符重叠复音支持情况及实现方案咨询

阿华AIGC实验室

2026-3-26

嘿，你观察到的这个现象完全是对的——AudioKit里的这几个主流采样器，默认确实都是限制同MIDI音符只能有一个活跃声部的，这可不是bug，而是为了贴合传统MIDI乐器的常规逻辑设计的。我来给你拆解下具体情况，再说说怎么实现你要的同音符复音效果：

一、主流采样器的默认行为

先明确每个采样器的现状：

DunneAudioKit Sampler：默认遵循MIDI规范，同音符触发会偷取之前的声部，或者直接终止前一个再触发新的，不支持同音符多声部。
MIDISampler：它是基于Apple的AVAudioUnitSampler封装的，底层的Apple采样单元本身就限制同音符单声部，所以它也继承了这个逻辑。
AppleSampler：和MIDISampler同源，依赖Apple的核心音频采样单元，默认同样不支持同音符多声部。

简单说，这些采样器的复音是“跨音符”的——不同音符可以同时发声，但同一个音符号只能有一个活跃声部，这是传统MIDI设备的标准行为。

二、实现同音符复音的可行方案

如果你需要让同一个MIDI音符号能同时发出多个重叠的声音，有几个实用的方案：

方案1：多采样器实例轮询（最易上手）

这是最直接的思路：创建多个配置完全相同的采样器实例（比如2个、4个，根据你需要的同音符声部数定），然后触发同音符时，轮流把事件发送给不同的采样器，最后把所有采样器的输出混合到主输出里。

举个Swift代码的简单例子，适配你的Sequencer场景：

// 1. 先创建多个相同配置的采样器
let sfzURL = Bundle.main.url(forResource: "your-sine-sfz", withExtension: "sfz")!
var samplers: [DunneSampler] = []
for _ in 0..<4 { // 这里设置支持最多4个同音符声部
    let sampler = DunneSampler()
    try? sampler.loadSFZ(url: sfzURL)
    samplers.append(sampler)
}

// 2. 混合所有采样器的输出
let mainMixer = Mixer(samplers)
AudioKit.output = mainMixer

// 3. 写一个轮询触发的工具函数
private var currentSamplerIndex = 0
func triggerOverlappingNote(noteNumber: MIDINoteNumber, velocity: MIDIVelocity) {
    // 把触发事件发送给当前轮询到的采样器
    samplers[currentSamplerIndex].play(noteNumber: noteNumber, velocity: velocity)
    // 轮询索引自增，循环复用采样器
    currentSamplerIndex = (currentSamplerIndex + 1) % samplers.count
}

// 4. 替换你原来的addNote逻辑
triggerOverlappingNote(noteNumber: 69, velocity: 127)
// 0.5秒后触发同音符的另一个声部
DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
    self.triggerOverlappingNote(noteNumber: 69, velocity: 30)
}

这个方案的好处是不需要改动采样器的底层逻辑，完全用现有API就能实现，而且每个采样器的声音参数完全一致，混合后不会有音色差异。

方案2：绕过MIDI音符触发（仅适用于DunneSampler）

DunneSampler提供了直接触发采样片段的API，不需要通过MIDI音符号关联。也就是说，你可以跳过MIDI事件的逻辑，直接让采样器播放音频片段，这样每次调用都会生成一个独立的声部，完全不受MIDI音符号的限制。

举个例子：

// 假设已经加载好SFZ文件
func triggerSineOverlap(velocity: MIDIVelocity) {
    // 直接触发第0个采样（你的SFZ里只有一个正弦波采样，所以索引是0）
    try? dunneSampler.playSample(at: 0, velocity: velocity, pitchBend: 0)
}

// 调用时，每次都会生成新的声部
triggerSineOverlap(velocity: 127)
DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
    self.triggerSineOverlap(velocity: 30)
}

这个方案更轻量，不需要管理多个采样器实例，但只适用于DunneSampler——MIDISampler和AppleSampler没有这类直接触发采样的开放API。

方案3：自定义Voice类（最灵活但稍复杂）

如果你需要完全自主控制声部的生命周期、偷取策略，可以基于AudioKit的AKVoice类自定义采样声部。简单来说，就是每个声部对应一个独立的采样播放实例，触发同音符时就新建一个Voice实例，把它加入混音器，播放完成后再销毁回收资源。

给你一个简化的代码框架参考：

// 1. 自定义一个采样声部类
class CustomSamplerVoice: AKVoice {
    private let playerNode = AVAudioPlayerNode()
    private let sampleBuffer: AVAudioPCMBuffer

    init(buffer: AVAudioPCMBuffer) {
        self.sampleBuffer = buffer
        super.init()
        attach(playerNode)
        connect(playerNode, to: output)
    }

    override func play() {
        // 播放采样，这里可以根据需要设置循环、音量等
        playerNode.scheduleBuffer(sampleBuffer, at: nil, options: [], completionHandler: nil)
        playerNode.play()
    }

    override func stop() {
        playerNode.stop()
    }

    override func renderSilence() -> Bool {
        return !playerNode.isPlaying
    }
}

// 2. 自定义采样器管理器
class MultiVoiceSampler {
    private let mixer = Mixer()
    private var activeVoices: [CustomSamplerVoice] = []
    private let sampleBuffer: AVAudioPCMBuffer

    init(sampleBuffer: AVAudioPCMBuffer) {
        self.sampleBuffer = sampleBuffer
        AudioKit.output = mixer
    }

    func triggerOverlappingNote(velocity: Float) {
        // 新建一个声部
        let voice = CustomSamplerVoice(buffer: sampleBuffer)
        // 调整音量（对应velocity）
        voice.volume = velocity / 127.0
        // 加入混音器并播放
        mixer.addInput(voice.output)
        activeVoices.append(voice)
        voice.play()

        // 自动回收已停止的声部（可选，避免内存泄漏）
        DispatchQueue.main.asyncAfter(deadline: .now() + 2.0) { [weak self, weak voice] in
            guard let self = self, let voice = voice else { return }
            voice.stop()
            self.mixer.removeInput(voice.output)
            if let index = self.activeVoices.firstIndex(of: voice) {
                self.activeVoices.remove(at: index)
            }
        }
    }
}

// 3. 使用示例
// 先把你的SFZ里的采样加载成AVAudioPCMBuffer
let sampleBuffer: AVAudioPCMBuffer = loadYourSampleBuffer()
let multiSampler = MultiVoiceSampler(sampleBuffer: sampleBuffer)
multiSampler.triggerOverlappingNote(velocity: 127)
DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
    multiSampler.triggerOverlappingNote(velocity: 30)
}

这个方案的优势是完全自定义，你可以自己控制声部的最大数量、偷取策略（比如声部满了就销毁最早的活跃声部），适合需要高度定制化的场景。