CefSharp 开发触屏终端遇到的问题记录
一、背景
最开始准备使用的 Chromely 做一个终端机项目,本来以为挺顺利的一个事情折腾了两天半。由于无法直接控制窗体的属性,最后还是切换到 .NET Framework 4.8 + CefSharp,记录一下遇到的坑和问题。
二、问题
2.1 输入法无法弹出
终端机系统最开始是 Windows 7,系统自带的输入法无法输入中文,后面使用的多文输入法有时候能够输入有时候不能够输入。最后折腾了半天,咨询厂家可以安装 Windows 10,安装后系统自带输入法可以输入中文。
新的问题又出现了,如果窗口没有全屏的情况下,输入法是可以将内容输入到网页的文本框。但是窗口置顶且全屏,触摸 输入的内容就像无法获取焦点一样,无法输入。
爬了很多网站,都没有给出个明确的答案,最后在 某篇 Issue 里面说将 browser.FocusHandler
属性设置为 null
,解决该问题。
2.2 重写右键菜单
这个问题比较简单,只需要重新实现 IMenuHandler
接口,替换掉 Cef Browser 的对应组件即可。
示例:
public class CustomMenuHandler : IContextMenuHandler
{
public void OnBeforeContextMenu(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IContextMenuParams parameters, IMenuModel model)
{
model.Clear();
model.AddItem((CefMenuCommand) 21000, "菜单项1");
}
public bool OnContextMenuCommand(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IContextMenuParams parameters, CefMenuCommand commandId,
CefEventFlags eventFlags)
{
if (commandId == (CefMenuCommand) 21000)
{
MessageBox.Show("我是菜单项1");
}
return false;
}
public void OnContextMenuDismissed(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame)
{
}
public bool RunContextMenu(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame, IContextMenuParams parameters, IMenuModel model,
IRunContextMenuCallback callback)
{
return false;
}
}
2.3 身份证读卡器对接
身份证读卡器终端机上面是集成新中新的,跟着 SDK 的 Demo 来,一跑程序就炸。没有跑出任何异常,最后发现是 Chromely 吞掉了异常。实际的错误问题是 DLL 的版本不对,新中新只提供了 x86 的 DLL,但程序编译的是 x64。最后将程序的目标平台改为 x86 解决问题。
2.4 前端同后端通讯
其实就是 JS 调用后端的接口,之前搜索的文章都是 CefSharp 的老版本代码,最新的是使用 browser.JavascriptObjectRepository.Register()
注入处理器,然后前端再进行调用。具体代码可以参考 CefSharp 的 官方 Demo。
2.5 打开调试窗口
CefSharp Browser 提供了一个 ShowDevTools()
方法用于打开调试窗口,需要注意的是,必须在浏览器完全初始化之后才能够调用。所以你需要判断一下 CefSharp Browser 的状态。
browser.IsBrowserInitializedChanged += (sender, args) =>
{
if (browser.IsBrowserInitialized)
{
browser.ShowDevTools();
}
};
2.6 关于触屏的其他配置
在 Cef 初始化的时候,需要对 Cef 进行一些其他的配置,例如开启触屏事件、禁用 USB 键盘等。
private static void InitializeCef()
{
CefSharpSettings.LegacyJavascriptBindingEnabled = true;
CefSharpSettings.SubprocessExitIfParentProcessClosed = true;
Cef.EnableHighDPISupport();
var settings = new CefSettings();
settings.CefCommandLineArgs.Add("disable-usb-keyboard-detect", "1");
settings.CefCommandLineArgs.Add("enable-media-stream", "1");
settings.CefCommandLineArgs.Add("touch-events", "1");
Cef.Initialize(settings);
}
2.7 允许前端跨域和调用摄像头
在 [2.6](#2.6 关于触屏的其他配置) 一节中,我通过添加 enable-media-stream
参数让前端可以直接调用摄像头。如果想要让前端发起跨域请求,就得在 Browser 里面将 WebSecurity
属性设置为 Disabled
。
browser.BrowserSettings.WebSecurity = CefState.Disabled;
2.8 下载文件
CefSharp 针对于前端的下载文件动作进行了处理,如果你对于这个动作有自己的处理逻辑,可以实现 IDownloadHandler
接口。然后在 Browser 的对应属性替换成你自己的实现即可。