@aura3d/physics

中文文档
4.7.0发布于 2026/10/31MITTypeScriptES Module

确定性刚体仿真,碰撞形状,接触,约束,光线投射,固定步进,场景/ECS桥,和调试绘制提取。

中文使用文档
文档目录3 节
  1. 公共API
  2. 验证
  3. 当前的限制

@aura3d /物理

@aura3d/physics 拥有确定性刚体仿真、碰撞形状、碰撞器、接触、约束、光线投射、固定步进、场景/ECS桥和调试绘图提取。

公共API

  • Shape:盒子、球体、胶囊、平面和索引三角形网格形状描述符以及边界帮助符。
  • RigidBody, Collider:身体状态,力,脉冲,过滤器,传感器,材料数据和快照。
  • CollisionEventQueue, Contact:开始/停留/结束事件状态和联系人数据。
  • Constraint:固定、铰链、滑块和弹簧式约束收缩。
  • PhysicsWorld:主体/碰撞器/约束所有权、确定性步进、接触求解、睡眠、光线投射、快照和移除事件。
  • PhysicsStepper:用于模拟滴答的定步累加器。
  • ScenePhysicsBridge, ECSPhysicsBridge:动态推和动态拉适配器。
  • PhysicsDebugDraw:稳定的调试行提取。

验证

确定性重播,重复固定输入仿真比较,宽相位对和分析计数器,形状验证,网格边界和背景感知光线投射,睡眠/唤醒,开始/停留/结束接触,接触过程中的移除,传感器,过滤器,光线投射,固定/铰链/滑块/弹簧约束,桥排序,调试绘制,浏览器物理像素和性能基线 tests/unit/workstream4.physics-animation.test.ts, tests/unit/physics/broadphase.test.ts, tests/browser/physics-browser.spec.ts, tests/performance/system-baselines.ts. 导出和导入一致性由 pnpm verify:exports 和 pnpm verify:imports.

当前的限制

  • 支持的碰撞形状描述符有盒子、球体、胶囊、平面和索引三角形网格。
  • 支持的约束契约包括固定约束、铰链约束、滑块约束和弹簧约束。
  • 目前不支持连续碰撞检测;快速移动的物体使用离散的固定步骤碰撞检查。
  • 内置的broadphase是确定性的扫描和修剪,带有公开的配置文件计数器,比成熟的本地物理后端更快的浏览器优先工作流。
  • 该包不要求车辆动力学,布料,柔软的身体,流体,可破坏的模拟,或大世界流物理。

版本与发布记录

@aura3d/physics 共发布 48 个版本,首次发布于 2026/06/06;过去 12 个月发布了 48 个版本。

版本发布日期距今
4.7.0latest2026/10/312 天前
4.6.22026/10/304 天前
4.6.12026/10/304 天前
4.6.02026/10/304 天前
4.5.02026/10/295 天前
4.3.72026/10/286 天前

关于 @aura3d/physics 的常见问题

@aura3d/physics 是什么?

确定性刚体仿真,碰撞形状,接触,约束,光线投射,固定步进,场景/ECS桥,和调试绘制提取。

如何安装 @aura3d/physics?

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

@aura3d/physics 支持 TypeScript 吗?

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

@aura3d/physics 支持 ESM 还是 CommonJS?

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

@aura3d/physics 可以商用吗?

@aura3d/physics 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@aura3d/physics 还在维护吗?

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