AudioUnitRender输出空音频缓冲区问题排查求助

1. 混音器输入端口的启用与配置 #

• 必须为每个绑定回调的混音器输入总线调用参数设置，明确开启输入：

  AudioUnitSetParameter(mixerUnit, 
                        kMultiChannelMixerParam_Enable, 
                        kAudioUnitScope_Input, 
                        inputBusIndex, 
                        1.0, 
                        0);
  

  注意混音器的输入总线默认从1开始计数（总线0为输出端），inputBusIndex要和你绑定回调的总线序号对应。
• 检查输入总线的音量参数是否被误设为0，确保音量处于正常范围：

  AudioUnitSetParameter(mixerUnit, 
                        kMultiChannelMixerParam_Volume, 
                        kAudioUnitScope_Input, 
                        inputBusIndex, 
                        1.0, 
                        0);
  

2. 全链路音频格式一致性检查 #

• 输入回调提供的音频格式、混音器的输入/输出格式、输出单元的输入格式必须完全匹配：采样率、声道数、位深（比如PCM 32位浮点）任何一项不匹配，都会导致混音器静默输出。
• 可以通过AudioUnitGetProperty读取各单元的kAudioUnitProperty_StreamFormat属性，逐一验证格式参数是否统一。

3. 单元连接与渲染流程校验 #

• 确认AudioUnitConnection配置正确：混音器的输出总线（总线0）要连接到输出单元的输入总线（通常为总线0）：

  AudioUnitConnection connection = {
      .sourceAudioUnit = mixerUnit,
      .sourceOutputNumber = 0,
      .destInputNumber = 0
  };
  AudioUnitSetProperty(outputUnit, 
                        kAudioUnitProperty_MakeConnection, 
                        kAudioUnitScope_Input, 
                        0, 
                        &connection, 
                        sizeof(connection));
  

• 如果手动调用AudioUnitRender，目标单元应为混音器而非输出单元；若依赖输出单元自动拉取数据，要确保输出单元的触发逻辑正常，没有被错误配置为静默模式。

4. Generic Output单元配置检查 #

• 确保输出单元的kAudioUnitProperty_StreamFormat与混音器输出格式完全一致，没有错误设置静音相关参数。
• 由于无法使用AVAudioSession，需通过底层音频会话API设置正确的类别并激活，比如：

  UInt32 sessionCategory = kAudioSessionCategory_PlayAndRecord;
  AudioSessionSetProperty(kAudioSessionProperty_AudioCategory, 
                          sizeof(sessionCategory), 
                          &sessionCategory);
  AudioSessionSetActive(true);
  

5. 输入回调细节验证 #

• 确认回调中ioData的所有声道缓冲区都被正确填充，而非仅填充第一个声道。
• 检查回调返回值是否为noErr，若返回错误，混音器会直接忽略该输入的数据。
• 不要在回调中修改inTimeStamp或inNumberFrames参数，这些参数由混音器控制，修改会导致同步异常。

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