Home
在 Unreal Engine 5 中嵌入原生级 Chromium 浏览器，把 Vue、React 与现代 Web 应用带入三维场景。
Windows · Linux x86_64 · Linux ARM64 · GLIBC ≥ 2.17
WebNativeBrowser 是面向 Unreal Engine 5.1–5.8 的高性能企业级跨平台 Web UI 与 Chromium 浏览器解决方案，让 Web 技术栈与 UE 三维渲染在同一画面里无缝协作。借助 GPU 直通渲染、智能帧率调节与 JS ↔ UE 双向消息通道，你可以用最快的速度把 Vue/React 前端、AI 应用界面或实时数据大屏落地到三维场景中。
- 基于 GPU 共享内存的跨进程纹理传输，画面直通 UE5 渲染管线，无 CPU 拷贝开销
- Windows D3D11/D3D12、Linux Vulkan，多渲染后端自适应
- 持久纹理复用，每帧零额外显存分配
- 静态画面零开销：页面静止时自动暂停渲染
- 动态内容按需渲染：动画、滚动实时唤醒
- 视频自适应帧率：自动匹配视频帧率，避免无效重复合成
- Windows x64、Linux x86_64、Linux ARM64 三大主流平台统一体验
- 同一份前端代码无需为不同平台重复适配
- 已完成砺算、摩尔线程等国产 GPU 专项适配
- 基于 Chromium 内核，覆盖 WebRTC、WebGL 2.0、MediaSource、Canvas
- 4K 视频，最高 8K 应用场景
- Widevine DRM、WebRTC、WebSocket、requestAnimationFrame 全部支持
- JS ↔ UE 消息通道：单条 < 1ms，10 万条 ~220 ms
- 蓝图/C++ 双端 API，自动 JSON 处理
- 单条消息上限 4 MiB（JS→UE）/ 2 MiB（UE→JS）
- 同一应用多浏览器控件 + 同一打包程序多实例
- 与 Unreal Engine Pixel Streaming 组合使用，支持云端渲染交付
- 18 项可配置的网页权限策略
- 离线授权验证机制、内置性能监视器与 DevTools 调试
三步跑通第一个 Web UI：
-
安装插件：选择与 UE 小版本和平台匹配的安装包，复制到项目
Plugins目录并启用。 -
创建网页：编写
hello.html，通过WebNative.send("OnHello", {...})向 UE 发消息。 -
加载与绑定：在 UMG 中放置 WebNative Browser 控件，设置
InitialURL，绑定OnMessageReceived并调用SendMessageToJS回复。
详细步骤见 01-快速开始。
按你的角色与目标，按顺序阅读即可：
| 章节 | 内容 | 文档 |
|---|---|---|
| ① 快速开始 | 安装插件、创建第一个 Widget、加载网页 | 01-快速开始 |
| ② 双向通讯 | JS ↔ UE 消息、类型兼容、协议设计 | 02-双向通讯 |
| ③ 参数配置 | WebNativeWidget 全部参数、事件与函数 | 03-WebNativeWidget 参数配置 |
| ④ 高级交互 | Web 拖拽/点击放置到 UE 场景 | 04-高级交互 |
| ⑤ 案例介绍 | 数字孪生、游戏、AI、报表的典型架构 | 05-案例介绍 |
| ⑥ CEF 配置 | ini 配置项、权限策略、命令行参数 | 06-CEF 参数配置 |
| ⑦ 文件上传下载 | 文件选择、上传、下载事件与提示 | 07-文件上传下载 |
| ⑧ 平台兼容性 | 支持范围、发布前测试矩阵 | 08-平台兼容性 |
| ⑨ 云渲染支持 | 多实例、多开与 Pixel Streaming | 09-云渲染支持 |
| ⑩ Linux 中文支持 | ARM64、中文输入、国产 GPU、单/多进程 | 10-Linux 中文支持 |
| ⑪ 疑难解答 | 常见问题、调试与排错 | 11-疑难解答 |
| ⑫ API 参考 | 蓝图 / JS 桥接 / C++ 接口速查 | 12-API 参考 |
| ⑬ 授权说明 | 授权方案、流程与授权文件放置 | 13-授权说明 |
| 项目 | 范围 |
|---|---|
| Unreal Engine | 5.1 – 5.8（每个版本独立包） |
| Windows | Win64，Windows 10+ |
| Linux | x86_64 / ARM64，最低 GLIBC 2.17（面向公开客户建议 2.31+） |
| 浏览器内核 | Chromium 内核 |
| 渲染后端 | D3D11 / D3D12（Windows）、Vulkan（Linux） |
| 最大帧率 | 120 FPS |
| 国产 GPU | 已完成砺算、摩尔线程专项适配 |
| 编程语言 | C++17 |
详细兼容性表与发布前测试清单见 08-平台兼容性。
- 源码 / Issue / Release：https://github.com/starTechnology1994/uewebbrowser
- 文档与 Wiki：https://github.com/starTechnology1994/uewebbrowser/wiki
- 问题反馈：https://github.com/starTechnology1994/uewebbrowser/issues
- 商务合作 / 授权咨询：startechnology1994@163.com
- WebNativeBrowser 版本（如 v1.0.0）
- Unreal Engine 版本（如 UE 5.4）
- 操作系统与架构（如 Windows 11 x64 / Ubuntu 22.04 ARM64）
- CPU、GPU 与驱动版本
- Development 或 Shipping 构建
- 最小复现步骤
- 脱敏后的日志（来自
<Project>/Saved/Logs/cef/）
- 机器码文件、.license 授权文件、客户业务数据、未脱敏日志 —— 不要 提交到公开 Issue 或 Wiki
- 授权相关问题请通过购买渠道联系授权方
- 安全漏洞请通过仓库 Security Advisories 私密报告
- 当前版本：v1.0.0
- 授权类型：个人版 / 商业版（详见 README 授权与定价章节）
- 闭源发布：Fab 商店
- 未经授权使用、复制、传播本插件源代码或二进制文件均属侵权；禁止逆向工程、反编译、反汇编
基于 Chromium Embedded Framework (CEF) 与 Unreal Engine 5 构建。