Xamarin iOS WkWebView中WebRTC后台运行时麦克风静音问题

这个问题不属于WkWebView的专属配置遗漏，本质是iOS系统级音频权限、后台模式配置缺失，以及WkWebView媒体权限授权逻辑不正确导致的——系统没有识别到你的应用在前台/后台持续使用麦克风，因此在应用切后台时自动切断了麦克风采集链路，仅保留音频播放权限，和你观察到的现象完全匹配。

必须完成的配置项 #

1. 补全Info.plist权限与后台模式配置 #

• 新增麦克风使用权限描述：添加NSMicrophoneUsageDescription字段，明确说明麦克风使用场景（例如“需要访问麦克风以实现语音通话功能”），缺少该字段时WkWebView无法向系统申请到完整的麦克风使用权限，不会触发状态栏的橙色麦克风调用提示。
• 开启音频后台能力：在UIBackgroundModes数组中添加audio项，对应Xamarin iOS项目配置里勾选后台模式的Audio, AirPlay, and Picture in Picture选项。缺少该权限时，iOS会在应用进入后台后自动切断所有音频输入流（麦克风采集），仅保留音频输出权限，正好对应你遇到的“下行音频正常、上行麦克风静音”的现象。

2. 正确配置全局音频会话 #

应用启动后、WebRTC通话初始化前，将全局AVAudioSession设置为支持录音+播放的类别，不要使用默认的仅播放类别，Xamarin.iOS参考代码如下：

using AVFoundation;

var audioSession = AVAudioSession.SharedInstance();
// 设置为可播放可录音类别，支持默认扬声器、蓝牙设备
audioSession.SetCategory(AVAudioSession.CategoryPlayAndRecord,
    AVAudioSessionCategoryOptions.DefaultToSpeaker | AVAudioSessionCategoryOptions.AllowBluetooth);
// 设置为语音通话模式，系统会自动优化音频采样率、回声消除参数
audioSession.SetMode(AVAudioSession.ModeVoiceChat, out _);
// 激活音频会话
audioSession.SetActive(true, AVAudioSessionSetActiveOptions.NotifyOthersOnDeactivation, out _);

注意：应用切后台的生命周期回调中，不要主动将音频会话设置为未激活状态，也不要切换为仅播放类别的会话，否则会直接中断麦克风采集。

3. 正确处理WkWebView的媒体权限请求 #

如果自定义实现了WkWebView的UIDelegate，必须正确处理麦克风权限申请回调：

• 实现DecidePolicyForMediaCapturePermission方法，对你信任的业务域名发起的麦克风采集请求，返回WKPermissionDecision.Grant授权，不要默认拦截、拒绝权限请求，否则WkWebView不会将麦克风使用状态同步给系统。
• 检查WKWebViewConfiguration配置，确保MediaTypesRequiringUserActionForPlayback属性没有限制音频类型，避免Web端的getUserMedia调用被WkWebView默认拦截。

配置完成验证标准 #

重新运行应用，首次触发通话时会弹出系统原生的麦克风权限申请弹窗，通话过程中iOS状态栏右上角会显示橙色的麦克风使用指示器，此时将应用切到后台，麦克风上行采集不会被静音，和Safari浏览器中的表现完全一致。

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