教程-示例-文档 

介绍

本文介绍在Energy中如何执行开发者工具方法

开发者工具方法，可以设置浏览器头，模拟仿真设备等.

使用方式

• 字典对象创建

cef.NewCefDictionaryValue()

• 字典对象是key=value方式, chromium定义的字典名称和对应的值，通过字典对象设置执行的参数
  • 字典对象有五种类型
  1. 字典本身类型 ICefDictionaryValue
  2. 字符串 String
  3. 整型  Int
  4. 浮点  Double
  5. 布尔  Boolean

• 示例 - 创建字典

//字典对象
var dict = cef.NewCefDictionaryValue()
//根据chromium字典设置
dict.SetInt("width", 500)
dict.SetBoolean("mobile", true)
dict.SetDouble("deviceScaleFactor", 1)
dict.SetString("type", "portraitPrimary")
TempDict := cef.NewCefDictionaryValue()
dict.SetDictionary("screenOrientation", TempDict)

• 执行开发者工具方法

Chromium().ExecuteDevToolsMethod(messageId, name, dict)

• 示例 - 调用访真设备方法

//字典对象
var dict = cef.NewCefDictionaryValue()
//根据chromium字典设置
dict.SetInt("width", 500)
dict.SetInt("height", 768)
dict.SetInt("x", 100)
dict.SetInt("y", 100)
dict.SetBoolean("mobile", true)
dict.SetDouble("deviceScaleFactor", 1)
TempDict := cef.NewCefDictionaryValue()
TempDict.SetString("type", "portraitPrimary")
TempDict.SetInt("angle", 0)
dict.SetDictionary("screenOrientation", TempDict)
//执行方法
windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setDeviceMetricsOverride", dict)

• 示例 - 设置浏览器 userAgent

dict := cef.NewCefDictionaryValue()
dict.SetString("userAgent", "Mozilla/5.0 (Linux; Android 11; M2102K1G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.101 Mobile Safari/537.36")
windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setUserAgentOverride", dict)

完整示例

一如既往先配置好go和energy环境, 然后创建一个main函数来创建应用

这个示例稍微有点复杂，使用了事件机制、内置资源和内置http服务。

内置http服务

启用了Energy简单的内置http服务-参考: 示例-内置http服务

//在主进程启动成功之后执行
//在这里启动内置http服务
//内置http服务需要使用 go:embed resources 内置资源到执行程序中
cef.SetBrowserProcessStartAfterCallback(func(b bool) {fmt.Println("主进程启动 创建一个内置http服务")//通过内置http服务加载资源server := assetserve.NewAssetsHttpServer()server.PORT = 22022               //服务端口号server.AssetsFSName = "resources" //必须设置目录名和资源文件夹同名server.Assets = &resourcesgo server.StartHttpServer()
})

事件监听

在应用初始化时使用 SetOnEvent 函数，监听Go消息事件

ipc.IPC.Browser().SetOnEvent(func(event ipc.IEventOn) {
})

通过 event.On 来监听一个事件

event.On(eventName, func(context ipc.IIPCContext){
})

事件触发

在web端使用js代码，ipc.emit 触发go监听的事件

ipc.emit(eventName,[callback function]);

• Go示例代码

package mainimport ("embed""fmt""github.com/energye/energy/cef""github.com/energye/energy/common/assetserve""github.com/energye/energy/ipc"
)//资源目录，内置到执行程序中
//go:embed resources
var resources embed.FSfunc main() {//全局初始化 每个应用都必须调用的cef.GlobalCEFInit(nil, &resources)//创建应用cefApp := cef.NewApplication(nil)//主窗口的配置//指定一个URL地址，或本地html文件目录cef.BrowserWindow.Config.DefaultUrl = "http://localhost:22022/execute-dev-tool-method.html"//chromium配置config := cef.NewChromiumConfig()config.SetEnableMenu(true)     //启用右键菜单config.SetEnableDevTools(true) //启用开发者工具cef.BrowserWindow.Config.SetChromiumConfig(config)//这里演示使用ipc通信实现js和go互相调用，在go监听事件中执行开发者工具方法//使用内置http服务和自定义页面//这里执行的方法是仿真移动端//1. js使用ipc.emit触发 go事件//2. go中"execute-dev-method"事件执行，通过context获得browserId//3. 通过browserId获得chromium//4. 使用字典对象传递方法参数//5. 点击Note链接ipc.IPC.Browser().SetOnEvent(func(event ipc.IEventOn) {event.On("execute-dev-method", func(context ipc.IIPCContext) {//获得当前窗口信息windowInfo := cef.BrowserWindow.GetWindowInfo(context.BrowserId())//字典对象var dict = cef.NewCefDictionaryValue()//根据chromium字典设置dict.SetInt("width", 500)dict.SetInt("height", 768)dict.SetInt("x", 100)dict.SetInt("y", 100)dict.SetBoolean("mobile", true)dict.SetDouble("deviceScaleFactor", 1)TempDict := cef.NewCefDictionaryValue()TempDict.SetString("type", "portraitPrimary")TempDict.SetInt("angle", 0)dict.SetDictionary("screenOrientation", TempDict)windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setDeviceMetricsOverride", dict)//设置浏览器 userAgentdict = cef.NewCefDictionaryValue()dict.SetString("userAgent", "Mozilla/5.0 (Linux; Android 11; M2102K1G) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.101 Mobile Safari/537.36")windowInfo.Chromium().ExecuteDevToolsMethod(0, "Emulation.setUserAgentOverride", dict)})})//在主进程启动成功之后执行//在这里启动内置http服务//内置http服务需要使用 go:embed resources 内置资源到执行程序中cef.SetBrowserProcessStartAfterCallback(func(b bool) {fmt.Println("主进程启动 创建一个内置http服务")//通过内置http服务加载资源server := assetserve.NewAssetsHttpServer()server.PORT = 22022               //服务端口号server.AssetsFSName = "resources" //必须设置目录名和资源文件夹同名server.Assets = &resourcesgo server.StartHttpServer()})//运行应用cef.Run(cefApp)
}

• html示例代码

dev-method-仿真
Note

示例效果图