X3DAudio与XAudio2集成问题：移动监听/音源后无声

问题描述 #

使用XAudio2实现3D位置音效时，监听者（Listener）和音源（Emitter）都在原点时音效正常播放，但只要移动其中任意一方，就听不到声音，不过音效仍处于播放状态。

相关代码片段 #

uint32_t sourceInputChannels = 2;
uint32_t masterInputChannels = 8;

float* outputMatrix = new float[masterInputChannels * sourceInputChannels];

// Listener
X3DAUDIO_LISTENER listener{};
listener.Position = { 0.0f, 0.0f, 0.0f };
listener.Velocity = { 0.0f, 0.0f, 0.0f };
listener.OrientFront = { 1.0f, 0.0f, 0.0f };
listener.OrientTop = { 0.0f, 0.0f, 1.0f };

// Emitter
X3DAUDIO_EMITTER sourceEmitter{};
sourceEmitter.ChannelCount = 1;
sourceEmitter.CurveDistanceScaler = FLT_MIN;
sourceEmitter.Position = { 0.0f, 0.0f, 0.0f };
sourceEmitter.Velocity = { 0.0f, 0.0f, 0.0f };
sourceEmitter.OrientFront = { 1.0f, 0.0f, 0.0f };
sourceEmitter.OrientTop = { 0.0f, 0.0f, 1.0f };
sourceEmitter.ChannelRadius = 2.0f;
sourceEmitter.InnerRadius = 2.0f;
sourceEmitter.InnerRadiusAngle = X3DAUDIO_PI / 4.0f;

X3DAUDIO_DSP_SETTINGS dspSettings{};
dspSettings.SrcChannelCount = sourceEmitter.ChannelCount; // 1

// 8 * 2, OUTPUT_CHANNELS is also present in CreateMasteringVoice
dspSettings.DstChannelCount = OUTPUT_CHANNELS * sourceVoiceDetails.InputChannels; 
dspSettings.pMatrixCoefficients = outputMatrix;

// Calculating
X3DAudioCalculate(g_CealContext->X3DInstance, &listener, &sourceEmitter, X3DAUDIO_CALCULATE_MATRIX | 
                X3DAUDIO_CALCULATE_DOPPLER | X3DAUDIO_CALCULATE_LPF_DIRECT | X3DAUDIO_CALCULATE_REVERB, &dspSettings);

sourceVoice->SetOutputMatrix(g_CealContext->XMasterVoice, sourceInputChannels, masterInputChannels, outputMatrix);
delete[] outputMatrix;

问题根源 #

• CurveDistanceScaler设置错误：你给sourceEmitter.CurveDistanceScaler赋值了FLT_MIN，这个极小值会让距离衰减曲线直接把音量压到0。XAudio2中该参数是距离缩放系数，需要设置为场景实际尺度的参考值（比如1.0代表1米），而非极小值。
• dspSettings.SrcChannelCount不匹配：源声音通道数是2，但你把dspSettings.SrcChannelCount设为了sourceEmitter.ChannelCount（1），导致矩阵计算维度错误。dspSettings.SrcChannelCount必须匹配实际源声音的通道数，而非Emitter的虚拟通道数。
• dspSettings.DstChannelCount计算错误：该参数应为主混音器的通道数（即masterInputChannels=8），你当前的计算方式会导致目标通道数超出预期，打乱音量矩阵的计算逻辑。

修复方案 #

修改以下代码：

// 1. 修正距离缩放系数为合理值，根据场景尺度调整
sourceEmitter.CurveDistanceScaler = 1.0f;

// 2. 匹配源声音实际通道数
dspSettings.SrcChannelCount = sourceInputChannels;

// 3. 设为主混音器通道数
dspSettings.DstChannelCount = masterInputChannels;

额外注意：如果你的源声音是立体声（sourceInputChannels=2），sourceEmitter.ChannelCount建议设为2；如果要将立体声作为单声道3D音源处理，需先将立体声混音为单声道，再设置sourceEmitter.ChannelCount=1，避免通道数不匹配引发异常。

额外建议 #

• 确保X3DAudioInitialize初始化时传入的声道配置与主混音器声道数一致（比如8声道对应X3DAUDIO_SPEAKER_7POINT1）。
• 监听者或音源位置变化后，需重新调用X3DAudioCalculate和SetOutputMatrix，保证音量矩阵实时更新。

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