Android WebRTC流始终将立体声音频下混为单声道问题求助

问题背景 #

使用org.webrtc:google-webrtc:1.0.32006库在Android STB设备（Amino Amigo、Amino H-200、小米手机等）播放Red5 Stream Manager的WebRTC立体声音频流时，设备始终将左右声道下混为单声道。已完成以下验证：

• PC Chrome和STB的Android Chrome中播放源音频正常，排除源文件问题；
• 日志确认接收流包含2声道（stats显示channels=2，sdpFmtpLine包含stereo=1）；
• 尝试过JavaAudioDeviceModule并配置setUseStereoOutput(true)，以及修改SDP、更新组件等操作，均未解决问题。

可能原因与解决方案 #

1. 音频设备模块配置遗漏 #

虽然设置了setUseStereoOutput(true)，但部分设备默认会忽略该配置，需强制开启立体声输出，同时同步配置输入侧立体声支持：

JavaAudioDeviceModule audioDeviceModule = JavaAudioDeviceModule.builder(context)
    .setUseStereoInput(true)
    .setUseStereoOutput(true)
    .setForceUseStereoOutput(true) // 关键：强制启用立体声输出
    .setAudioRecordErrorCallback(errorCallback)
    .setAudioTrackErrorCallback(errorCallback)
    .createAudioDeviceModule();

PeerConnectionFactory.initialize(PeerConnectionFactory.InitializationOptions.builder(context)
    .setAudioDeviceModule(audioDeviceModule)
    .createInitializationOptions());

2. 显式强制音频轨道声道数 #

在创建音频轨道时，明确指定声道数为2，避免WebRTC自动适配为单声道：

AudioTrack audioTrack = factory.createAudioTrack("audio-track", audioSource);
audioTrack.setParameters(new MediaStreamTrack.Parameters.Builder()
    .setAudioChannels(2)
    .build());

3. 设备系统音频限制排查 #

部分Android STB或定制化系统默认强制单声道输出，需手动检查或配置：

• 进入设备「声音设置」，关闭「单声道音频」选项；
• 通过adb命令强制设置系统立体声输出：

adb shell setprop persist.audio.stereo true
adb shell media volume --stream 3 --set 100 # 确保媒体音量正常加载

4. WebRTC版本兼容性修复 #

旧版本WebRTC库在Android设备上存在声道映射bug，建议升级到最新稳定版（如1.0.35000及以上），新版本修复了多个音频适配问题。

5. SDP精细化校验与修改 #

确保Offer/Answer阶段的SDP完整保留立体声参数，在生成Offer后手动补充声道声明：

a=fmtp:111 stereo=1;sprop-stereo=1
a=rtpmap:111 opus/48000/2

接收Answer时验证对方是否返回对应参数，若缺失则手动补充后再设置到PeerConnection。

代码验证建议 #

在WebRTCNativeClient中添加音频数据监听，确认接收端声道数是否正确：

audioTrack.addSink(new AudioSink() {
    @Override
    public void onData(ByteBuffer buffer, int bitsPerSample, int sampleRate, int numberOfChannels, int numberOfFrames) {
        Log.d("WebRTC-Audio", "Received audio channels: " + numberOfChannels);
    }
});

若日志显示numberOfChannels=2但输出仍为单声道，说明问题出在设备音频输出适配层，需重点排查系统音频设置或JavaAudioDeviceModule的底层适配。

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