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来获取

CefSharp 使用心得

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

CefSharp 使用心得CefSharp 使用心得

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

CefSharp 使用心得

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

CefSharp 使用心得

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

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

心得

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

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

CefSharp 使用心得

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。