MacOS音频开发：AUGraph API借助子图实现多输出是否可行？

限制验证 #

你查阅到的信息属实：AUGraph原生仅支持单输出拓扑结构，每个实例只能绑定一个输出Audio Unit节点，属于苹果官方未修复的已知设计限制，拆分多子图分别绑定独立输出是经过验证的可行绕过方案。

实现思路 #

• 将原有单AUGraph按输出链路拆分为多个独立子AUGraph，每个子图仅负责一路输出的音频处理逻辑
• 公共音频数据源、通用音效节点如果需要多链路共享，可通过RenderCallback回调将音频数据注入不同子图，避免重复计算
• 所有子图需保持相同的采样率、帧长、StreamFormat配置，避免音频不同步或卡顿问题

核心示例代码（基于AudioToolbox框架，iOS/macOS通用） #

// 初始化单个输出子图的方法
- (AUGraph)createSubGraphWithOutputType:(AudioUnitSubType)outputType error:(NSError **)error {
    AUGraph subGraph;
    OSStatus status = NewAUGraph(&subGraph);
    if (status != noErr) {
        *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:status userInfo:nil];
        return NULL;
    }

    // 1. 添加输出节点
    AudioComponentDescription outputDesc = {0};
    outputDesc.componentType = kAudioUnitType_Output;
    outputDesc.componentSubType = outputType; // 例：kAudioUnitSubType_RemoteIO对应扬声器输出，kAudioUnitSubType_HALOutput对应自定义音频设备
    outputDesc.componentManufacturer = kAudioUnitManufacturer_Apple;
    AUNode outputNode;
    status = AUGraphAddNode(subGraph, &outputDesc, &outputNode);
    if (status != noErr) {
        *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:status userInfo:nil];
        return NULL;
    }

    // 2. 添加混音器节点（如需在子图内做单独音效处理）
    AudioComponentDescription mixerDesc = {0};
    mixerDesc.componentType = kAudioUnitType_Mixer;
    mixerDesc.componentSubType = kAudioUnitSubType_MultiChannelMixer;
    mixerDesc.componentManufacturer = kAudioUnitManufacturer_Apple;
    AUNode mixerNode;
    status = AUGraphAddNode(subGraph, &mixerDesc, &mixerNode);
    if (status != noErr) {
        *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:status userInfo:nil];
        return NULL;
    }

    // 3. 绑定混音器输出到输出节点输入
    status = AUGraphConnectNodeInput(subGraph, mixerNode, 0, outputNode, 0);
    if (status != noErr) {
        *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:status userInfo:nil];
        return NULL;
    }

    // 4. 给混音器设置输入回调，注入共享的音频数据
    AudioUnit mixerUnit;
    status = AUGraphNodeInfo(subGraph, mixerNode, NULL, &mixerUnit);
    AURenderCallbackStruct inputCallback = {
        .inputProc = sharedAudioRenderCallback,
        .inputProcRefCon = (__bridge void *)(self) // 传入持有共享音频缓冲的实例
    };
    status = AudioUnitSetProperty(mixerUnit, kAudioUnitProperty_SetRenderCallback, kAudioUnitScope_Input, 0, &inputCallback, sizeof(inputCallback));
    if (status != noErr) {
        *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:status userInfo:nil];
        return NULL;
    }

    // 5. 打开并初始化子图
    status = AUGraphOpen(subGraph);
    status = AUGraphInitialize(subGraph);
    if (status != noErr) {
        *error = [NSError errorWithDomain:NSOSStatusErrorDomain code:status userInfo:nil];
        return NULL;
    }

    return subGraph;
}

// 共享音频渲染回调，给所有子图注入相同的处理后音频数据
static OSStatus sharedAudioRenderCallback(void *inRefCon,
                                          AudioUnitRenderActionFlags *ioActionFlags,
                                          const AudioTimeStamp *inTimeStamp,
                                          UInt32 inBusNumber,
                                          UInt32 inNumberFrames,
                                          AudioBufferList *ioData) {
    YourAudioManager *manager = (__bridge YourAudioManager *)inRefCon;
    // 此处填入原有音频混合、音效处理逻辑，将处理好的音频数据拷贝到ioData中
    // 注意多线程安全：共享音频数据源需加锁访问，避免不同子图回调同时读写数据
    memcpy(ioData->mBuffers[0].mData, manager.sharedAudioBuffer, inNumberFrames * sizeof(float) * 2); // 示例为双声道浮点格式
    return noErr;
}

// 初始化双输出逻辑示例
- (void)setupDualOutput {
    NSError *error;
    // 子图1：输出到设备扬声器
    self.speakerGraph = [self createSubGraphWithOutputType:kAudioUnitSubType_RemoteIO error:&error];
    // 子图2：输出到指定外接音频设备
    self.externalOutputGraph = [self createSubGraphWithOutputType:kAudioUnitSubType_HALOutput error:&error];

    // 同时启动两个子图，保持输出同步
    AUGraphStart(self.speakerGraph);
    AUGraphStart(self.externalOutputGraph);
}

注意事项 #

• 所有子图的音频流格式必须完全一致，包括采样率、位深、声道数，否则会出现音频失真或者同步问题
• 共享音频数据的读写需要加线程锁，避免多个子图的渲染回调同时读写同一块内存导致崩溃
• 由于AUGraph已被苹果废弃，新开发项目建议优先迁移到AVAudioEngine方案，原生支持多输出配置，无需额外做子图拆分

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