PixiJS 为 2D 场景加入 3D,并以 MIT 许可开放测试版
PixiJS 团队开放了 PixiJS 3D 的公开测试版,这是其浏览器 2D 引擎的官方三维扩展。3D 场景在这里作为 2D 场景的普通元素接入:它被添加到与精灵、文本和界面相同的画布上,并与它们在共同的图层顺序中一起绘制。对于用 PixiJS 制作浏览器游戏、推广内容和交互界面的工作室来说,这意味着可以把 3D 模型插入到已经完成的项目中。既不需要重写项目,也不需要在旁边运行第二个引擎。
该扩展免费,并以 MIT 许可发布。开发者首先针对 WebGPU 进行设计,同一份场景代码也能在 WebGL2 上运行。API 目前尚未固定,团队承诺在整理完公开测试参与者的反馈之后发布 1.0 版本。
「它是免费的。MIT 许可,而且永远如此」。
——PixiJS 团队在公开测试版公告中
场景上的 3D 视图像精灵一样摆放
整个三维场景都存在于一个独立的 3D 视图内部,而该视图本身在 2D 场景中表现得像一个精灵。这样的视图可以放置多个,并且位于构图中的任意位置,每个都有自己的场景和摄像机,多视图示例展示了这一点。叠加顺序很简单:在列表中靠后的 2D 元素绘制在 3D 之上,而靠前的元素如果视图没有设置背景,就会透过它显示出来。在演练场中有一个场景,玻璃质感的 3D 徽标会折射其后方绘制的 2D 海报。
不过 2D 和 3D 仍然是彼此分开的世界。精灵不能放进 3D 树中,3D 节点也不能直接放到 2D 场景上。要在 3D 对象的表面显示 2D 界面,需要把它渲染到一张纹理上,这张纹理可以每帧更新。在网站的示例中,立方体的各个面上就这样显示着一个实时的 2D 容器,而在公告中,一个带时钟的 2D 场景出现在 3D 显示器的屏幕上。对于跟随 3D 对象的标注,提供了从场景空间到屏幕坐标的坐标换算。默认情况下,3D 视图会在其整个矩形区域内拦截点击和悬停,因此在未配置这一行为之前,它下方的 2D 按钮无法被按下。指针也会对 3D 对象本身作出响应。
引擎能做什么
- 模型。可加载 .gltf 或 .glb 形式的 glTF 2.0,支持 Draco 和 meshopt 几何压缩、压缩纹理、蒙皮、morph targets 和动画。动画片段按名称播放,就像网站演示中的狐狸模型那样。
- 材质。提供 PBR、Phong、flat 和 toon,可以编写自定义材质,包括多次渲染通道的材质。
- 光照与画面。有阴影(包括级联阴影)、HDR、色调压缩、渲染图和后处理,其中包括 bloom 和 ambient occlusion。
- 其他。附带粒子以及可围绕对象环绕飞行的摄像机。
同一个道具的副本几乎不耗费资源。每个模型构建自己的节点,但共用几何体、材质和纹理,就像精灵共用一张纹理那样。如果把同一个文件中的多个箱子摆放到关卡里,该文件只会加载一次。对于数千个副本,还准备了单独的批处理模式。
无需手工优化的速度
本次发布的主要承诺是:以最直观的方式搭建出来的场景,本身就应该运行得很快。开发者比较了不同的渲染方式,引擎会自行选择适合设备、浏览器和具体场景的方式。共用几何体和材质的对象会自动合并为一次实例化绘制调用。共用几何体和材质的五个立方体在一次调用中绘制完成,来自同一个模型文件的十二个带动画角色同样只需一次。
在大多数支持 WebGPU 的浏览器中,不可见对象的剔除在显卡上通过计算着色器完成。在 Safari 以及任何 iPhone 和 iPad 上,对于典型场景由处理器计算,而当对象批次足够大时就转移到显卡上。引擎只重新计算发生变化的网格,因此静态场景几乎不占用处理器。这大概对于 3D 对象大部分时间静止不动的界面尤其有用。每个浏览器只下载自己需要的后端,WebGPU 或 WebGL2。
在批处理演示中,屏幕上有 10 万个带阴影的对象,帧率为每秒 60 帧。这些数字是在什么硬件上取得的,公告中没有说明。为了展示引擎在基准测试之外的表现,团队在其实验展示平台 Good Stuff 上发布了两款游戏。Nightward 的全部图形和音乐都由代码生成,不加载任何图像或声音文件。Mach 2 可在 WebGPU 和 WebGL2 上运行,可以用键盘玩,也可以在手机上玩。团队承诺新的 3D 实验作品也会发布到同一个地方。
搭建场景时需要注意什么
3D 部分有自己的坐标系,习惯用 2D 像素工作的人需要适应。Y 轴朝上,单位为米。摄像机默认不绘制超过 1000 单位之外的内容,因此按像素尺寸搭建的场景会被裁掉。模型可能需要缩放:在狐狸演示中,模型被缩小到原始尺寸的 0.01。
第二个细节与兼容性有关。如果浏览器选择了 WebGPU,但显卡缺少所需的功能,应用不会自动切换到 WebGL2,而会在启动时报错。文档中说明了如何提前检查支持情况。对于手机,指南建议把像素密度限制为 2:在三倍密度的屏幕上,这能把绘制的像素数量减少一半以上。
封闭测试已经暴露出一些典型问题。从 Blender 导出的内容会让 glTF 加载器崩溃,而在某些 Android 手机上,着色器请求的参数数量超过了 WebGL2 允许的上限。测试者总共提交了 30 多份错误报告和功能请求,其中大部分已经进入此次发布。
从哪里获取以及如何开始
@pixi/3d 包随 pixi.js 一起通过 npm 或从 CDN 安装,要求 pixi.js 版本为 8.23.0 或更高。源码位于 GitHub 上的 PixiJS 3D 仓库,文档和示例汇集在 PixiJS 3D 页面。那里有 35 篇指南、100 多个交互示例以及三个可直接在浏览器编辑器中运行的教程。入门课程会一步步搭建出地面上的一个旋转立方体,放置摄像机和定向光,然后加载一个 glTF 模型。
随扩展一同发布的还有面向 AI 智能体的技能,它可以接入 Claude Code、Cursor、Codex 和 Copilot,并包含在 npm 包中。文档以便于语言模型使用的 llms.txt 格式发布。开发者自己称 PixiJS 3D 是引擎第八版以来 PixiJS 最大的一次补充。
谁会用得上,风险在哪里
PixiJS 早就有一个由独立开发者制作的第三方 3D 扩展 Pixi3D。它支持 PBR 和基于环境贴图的光照,其作者称其已在数十万台设备上投入生产使用,但它兼容的是 PixiJS 5、6 和 7 版本。官方包面向第八分支,从 8.23.0 起。使用旧版 Pixi3D 项目的工作室大概首先得把项目迁移到当前的 PixiJS,然后才能转用新扩展。相关资料中没有描述现成的迁移路径。
看起来受益最大的是项目基础为二维的团队:休闲浏览器游戏、playable 广告、交互式落地页以及带有个别 3D 元素的界面。他们不再需要在项目中保留第二个渲染器并与 2D 层同步。对于需要完整 3D 场景、2D 内容极少的项目,优势就不那么明显:开发者没有给出与大型 Web 3D 引擎的比较。
最主要的风险源自其本身的状态:API 在 1.0 之前仍可能变化,现在写的代码或许需要修改。此外值得单独检查从 Blender 导出模型以及在 Android 设备上的表现:封闭测试正是在这些地方发现了故障,其中包括在某些手机上触及 WebGL2 的限制。
你会把 PixiJS 3D 的 3D 视图嵌入到哪里?
- 休闲浏览器游戏
- playable 广告