@babylonjs/lite

中文文档
1.38.2发布于 2026/11/06Apache-2.0TypeScriptES Module近 30 天下载 1.6万

一个轻而易举,可树可摇动,WebGPU-第一渲染库从巴比伦.js.

中文使用文档
文档目录8 节
  1. 安装
  2. 快开始
  3. 打开美元
  4. 文档
  5. 可选导航
  6. 无头模拟( null 引擎)
  7. 右手坐标系统
  8. 许可证

巴比伦语Name

一个轻而易举,可树可摇动,WebGPU-第一渲染库来自 巴比伦.js。只导入您使用的东西并发送 最低捆绑.

安装

npm install @babylonjs/lite

快开始

import { createEngine, createSceneContext, createDefaultCamera, createHemisphericLight, addToScene, loadGltf, registerScene, startEngine } from "@babylonjs/lite";

async function main(): Promise<void> {
    const canvas = document.getElementById("renderCanvas") as HTMLCanvasElement;

    const engine = await createEngine(canvas);
    const scene = createSceneContext(engine);

    addToScene(scene, await loadGltf(engine, "https://playground.babylonjs.com/scenes/BoomBox.glb"));
    addToScene(scene, createHemisphericLight([0, 1, 0], 1.0));
    createDefaultCamera(scene);

    await registerScene(scene);
    await startEngine(engine);
}

main().catch(console.error);

打开美元

loadUsd() 负载 .usd, (中文(简体) ), .usda, (中文(简体) ), .usdc,以及 .usdz 同样的 协议版 OpenUSD WebAssembly.js 使用的网络大会提取器 将命令/数据缓冲器作为本地的列表实体实现 :

import { addToScene, loadUsd } from "@babylonjs/lite";

const asset = await loadUsd(engine, "/assets/model.usdz");
addToScene(scene, asset);

对于组成阶段,通过每个外部层、有效载荷和纹理 虚拟 files 地图,同时保存作者路径 :

const asset = await loadUsd(engine, rootLayer, {
    rootFileName: "Package/Scenes/Main.usda",
    files: {
        "Package/Layers/Geometry.usdc": geometryLayer,
        "Package/Textures/Albedo.png": albedo,
    },
});

工人,胶水,WASM,和数据捆绑默认巴比伦. js CDN. 设定 runtimeBaseUrl 到包含全部四个协议v5文件的目录 自我接待他们.

文档

完整的文件可在 https://doc.babylonjs.com/lite/ (中文(简体) )。 。 。 .

可选导航

导航 装入离线的 JSON 并运行纯 JavaScript 路径/表面查询 温和。 生成, 离地变异和CPU调试几何是独立的 选项。 现有的重铸后端仍然可用. 参见 Navcat 实验室演示 用于过滤器、网格替换和处置/再装入.

无头模拟( null 引擎)

巴比伦 字迹可以运行 没有 GPU 或画布 用于服务器侧物理, 决定性模拟,或CI——巴比伦的文学模拟.js NullEngine。 。 。 . 使用 createNullEngine() 改为 createEngine()循环 {\fn黑体\fs20\shad2\2ah82\3ah20\4ah33\fscx95\3ch592001\be1}你对你的爱 stepScene()数字 :

import { createNullEngine, stepScene, createSceneContext } from "@babylonjs/lite";

const engine = createNullEngine(); // no device, no canvas — synchronous
const scene = createSceneContext(engine, { defaultRenderTask: false });

// ...add physics bodies / onBeforeRender callbacks...

for (let i = 0; i < 180; i++) stepScene(engine, scene, 1000 / 60); // simulate 3s

它不需要WebGPU,运行在平地节点(推荐),Deno,Web Workers,或 CI 渲染超出了范围 见 无头( Null 引擎) 指南 详细情况, 支持运行时间和限制.

右手坐标系统

巴比伦 立特默认为左撇子. 像巴比伦那样右手 与 scene.useRightHandedSystem = true中,添加 babylon-lite-rh 页:1 条件与你的捆绑。 你的密码不会改变的,而手性是 恒定修饰器折叠起来: 与 Rolldown, 建立实验室场景, a 左手包是这个选项存在之前 构建的字节. {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}还保留了手性检查和几个小帮手 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}所以它的捆绑会不断增长 有点.

模块 lib/ 导入 #coordinate-system,在 这个包裹 imports 地图。 读取器 imports (Vite,网页包装5), 兴起、倒地、倒地 @rollup/plugin-node-resolve(a) 解决 浏览器 ESM 和捆绑器 imports 支持没有。 预设 dist/index.js 没有这种进口,是左撇子.

// vite.config.ts
import { defineConfig, defaultClientConditions } from "vite";

export default defineConfig({
    resolve: { conditions: [...defaultClientConditions, "babylon-lite-rh"] },
});

包里每个引擎都是右手的 见 右手式坐标系统指南 页:1 网络包装, 建设和滚出, 和覆盖的特性到目前为止.

许可证

阿帕奇 - 2.0

@babylonjs/lite 是一种衍生物 巴比伦.js (阿帕切-2.0) (中文(简体) ). 它将少量第三方运行时库捆绑在一起 (单位:千美元)manifold-3d, (中文(简体) ), @recast-navigation/*, (中文(简体) ), text-shaper, (中文(简体) ), navcat, (中文(简体) ), mathcat里面的密码船 已发布的软件包。 他们的许可证文本,以及 嵌入其WebAssembly的上层原生组件(重铸并绕道和 ——载于 注意到.txt。 。 。 .

仅用于开发的工具(建设、测试和油漆框架) 没有 部分内容 因此没有再分配义务.

版本与发布记录

@babylonjs/lite 共发布 49 个版本,首次发布于 2026/06/04;过去 12 个月发布了 49 个版本。

版本发布日期距今
1.38.2latest2026/11/061 天前
1.38.12026/11/052 天前
1.38.0-previewpreview2026/11/043 天前
1.38.02026/11/025 天前
1.37.22026/10/299 天前
1.37.12026/10/2810 天前

关于 @babylonjs/lite 的常见问题

@babylonjs/lite 是什么?

一个轻而易举,可树可摇动,WebGPU-第一渲染库从巴比伦.js.

如何安装 @babylonjs/lite?

在项目目录运行 npm install @babylonjs/lite,或使用 pnpm add / yarn add / bun add。

@babylonjs/lite 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@babylonjs/lite 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@babylonjs/lite 可以商用吗?

@babylonjs/lite 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@babylonjs/lite 的下载量有多少?

根据 npm 官方下载统计,@babylonjs/lite 在 2026/10/08 – 2026/11/06 这 30 天内被下载 15,623 次,日均约 521 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@babylonjs/lite 还在维护吗?

最新版本 1.38.2 发布于 2026/11/06(1 天前);至今共发布 49 个版本,其中过去 12 个月发布了 49 个;首次发布于 2026/06/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。