CefSharp 使用心得

前言

前段时间做的一个项目，使用WPF开发，项目中需要对接声网的视频通话功能，经过一番研究，声网提供了C++的SDK，而且视频通话的窗口需要使用句柄来实现，对于WPF来说可能过于艰难了，于是放弃C++接口，选择了web的SDK，那对于web的视频功能要么是通过flash实现，要么是通过google的WEBRTC技术实现。声网的web sdk就是webRTC技术，那作为.net系自然不可能用自带的浏览器实现这一功能，于是开始了对Cefsharp的研究。

官方资料

        GitHub:https://github.com/cefsharp/CefSharp/

入门

Cefsharp 本身是一个开源项目，而且维护的比较频繁，基本上是跟随chrome的内核升级的，可以直接通过NuGet来获取

      等下载完将相关dll引入到项目中，编译后相关的dll会自动引入到生成目录下

 由于cefsharp必须指定项目配置平台，所以在生成前需要先设置一下X86平台：

 现在就可以开始配置初始化参数了：

 这些都需要在App.xaml.cs里初始化，如果在页面的构造函数里初始化可能会出现未知的情况（比如无法获取到摄像头等）。

下面就是界面上的事了，直接初始化一个ChromiumWebBrowser，给Address 赋值即可。

心得

1、上面提到的最好在App.xaml.cs里初始化CefSettings，允许调用摄像头，忽略证书等。

2、允许调用摄像头的设置以下三种都可以，如果遇到报错“NotAllowedError”，则多半是没有打开该设置。

3、要测试webRTC的视频通话功能的话，你的测试地址必须是https加密的，这个是chrome官方要求的。如果证书过期可以加上忽略证书参数，上面的截图里有。

4、打开F12调试功能的话，只需要myBrowserVideo.ShowDevTools()

5、要实现下载功能的话只需要继承IDownloadHandler ，然后实现其中的方法即可。

6、要实现与js代码通信只需要注册：myBrowserVideo.RegisterJsObject("callbackObj", new CallbackObjectForJs());记得区分大小写

补充一下，关于webRTC回调错误类型：

失败回调函数errorCallback的参数error，可能的异常有：

• AbortError：硬件问题
• NotAllowedError：用户拒绝了当前的浏览器实例的访问请求；或者用户拒绝了当前会话的访问；或者用户在全局范围内拒绝了所有媒体访问请求。
• NotFoundError：找不到满足请求参数的媒体类型。
• NotReadableError：操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问。
• OverConstrainedError：指定的要求无法被设备满足。
• SecurityError：安全错误，在getUserMedia() 被调用的 Document上面，使用设备媒体被禁止。这个机制是否开启或者关闭取决于单个用户的偏好设置。
• TypeError：类型错误，constraints对象未设置［空］，或者都被设置为false。