渲染引擎 / Render Engine

ThreeX

把 three.js 引擎移植到全平台,方便开发原生沉浸式体验。

可用THREE.JS
Booth ImageThreeX 展位图 / 主视觉

Value / 带来什么

带来什么

01

原工程接着用

场景、材质、光照与后处理沿用 three.js 原实现,接入时不必重写。

02

一次出四个端

小程序、App、桌面与 XR 共用同一份内容。

03

重负载有退路

渲染后端可切 WebGL、WebGPU 与平台原生图形接口。

How It Works / 原理

原理

上游three.js
定位three.js 的跨平台运行时,覆盖最全的一条。
关键能力场景、材质、光照、后处理沿用原实现;渲染后端可切;宿主生命周期接管。
接入方式把 WebGLRenderer 换成渲染引擎入口,注册宿主画布与输入。
适用场景已有 three.js 项目的多端发布,尤其是要保留原美术管线与 shader 的工程。
与上游差异DOM 相关能力(CSS3DRenderer、DOM 叠加层)需换成宿主等价实现。

Platforms / 平台支持

平台支持

小程序可用
原生 App可用
桌面可用
XR可用

接入 / Integration

接入三步

三步是真实序列,按 01 / 02 / 03 执行。

01

引入兼容层 SDK

按所用上游引擎选择对应的运行时包,场景、材质与动画写法保持不变。

02

替换渲染入口并注册宿主

把浏览器侧 Renderer 换成运行时渲染入口,注册宿主画布与输入。

03

按终端接入资源与后端

配置资源加载通道与渲染后端,按平台裁剪包体,完成出端验证。

接入 / Integration

代码对比

浏览器侧写法换成运行时入口,业务逻辑不动。

before · three.js
import * as THREE from 'three';

const renderer = new THREE.WebGLRenderer({ canvas });
renderer.setSize(width, height);

function loop() {
  requestAnimationFrame(loop);
  renderer.render(scene, camera);
}
loop();
// 依赖 DOM 画布与浏览器 rAF
after · 渲染引擎兼容层
import { createRenderer } from '@onekit/render';

const renderer = createRenderer({
  canvas: host.canvas,      // 注册宿主画布
  input:  host.input,       // 注册宿主输入
  backend: 'webgl',        // 后端可切
});

renderer.mount(scene, camera);
// 渲染循环由宿主生命周期接管

评估 ThreeX

提供现有工程与目标终端,我们按项目给出接入路径。

联系我们