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。