使用CEFSharp打开Microsoft Teams时createOffer执行错误如何解决？

AI 小北

2026-10-6

报错产生原因

CEFSharp默认未开启完整WebRTC特性，且未默认授予Teams站点麦克风、摄像头的持久访问权限。当执行静音/取消静音操作时，Teams会触发RTCPeerConnection的SDP重协商流程，此时createOffer调用缺少合法的媒体轨道授权，直接抛出OperationError异常。
缺少Chrome默认开启的WebRTC相关启动参数。Chrome默认启用了一系列和WebRTC媒体协商、SDP生成相关的实验特性，CEFSharp默认未携带这些配置，导致Teams的SDP offer生成逻辑不被内核支持。
CEFSharp内核版本过旧。旧版本CEFSharp的WebRTC实现存在已知的createOffer调用逻辑BUG，和新版Teams前端依赖的WebRTC标准接口不兼容，Chrome因为内核保持实时更新所以无此问题。
媒体设备授权无持久化配置。CEF默认每次访问媒体设备都需要触发用户授权弹窗，静音操作触发媒体设备重枚举时如果没有即时拿到授权，也会导致PeerConnection创建offer失败。

修复方案

初始化CEF时添加WebRTC相关启动参数，在CefSettings实例化阶段添加以下配置：

var settings = new CefSettings();
// 开启完整WebRTC支持
settings.CefCommandLineArgs.Add("enable-webrtc");
// 开启WebRTC stun origin支持
settings.CefCommandLineArgs.Add("enable-webrtc-stun-origin");
// 开启媒体会话服务
settings.CefCommandLineArgs.Add("enable-media-session-service");
// 自动授予媒体设备权限，跳过授权弹窗
settings.CefCommandLineArgs.Add("use-fake-ui-for-media-stream");
Cef.Initialize(settings);

实现自定义请求处理器，自动授予Teams站点媒体权限：通过重写IRequestHandler的OnPermissionRequest方法，对Teams域名的音视频捕获请求直接授予权限，避免授权流程阻塞SDP协商。

public bool OnPermissionRequest(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, string requestId, PermissionRequestType permissions, IPermissionRequestCallback callback)
{
    if (frame.Url.StartsWith("https://teams.microsoft.com") 
        && permissions.HasFlag(PermissionRequestType.AudioCapture | PermissionRequestType.VideoCapture))
    {
        callback.Continue(permissions);
        return true;
    }
    return false;
}

升级CEFSharp到最新稳定版：建议升级到118及以上版本，保持Chromium内核与主流Chrome版本对齐，适配新版Teams的WebRTC调用逻辑。
配置浏览器实例的媒体开关：创建CefBrowser实例时，将CefBrowserSettings的MediaStreamEnabled属性设置为true，确保媒体流相关特性完全开启。

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