@aura3d/navigation-recast

中文文档

4.7.0发布于 2026/10/31MITTypeScriptES Module

可选的Aura3D异步初始化重铸/绕行导航适配器。

@aura3d / navigation-recast

可选的重铸/绕行导航Aura3D，由精确的支持 [email protected]．静态世界通常应该构建和序列化它们的导航网格离线，然后惰性地初始化这个包并导入该数据在运行时。运行时生成仍然可以用于过程世界。

该包不包括核心、产品和街机游戏条目。它拥有导航网格生成，路径查询，序列化，绕行人群模拟，和 temporary-obstacle集成;它不依赖Three.js。

createRecastNavigation() 初始化WASM运行时一次，并返回瘦工厂/查询适配器。
generateSolo() 从索引三角形数据创建一个小世界导航网格。
import() 恢复离线生成的导航网格。
importAsset() 加载一个cli生成的文件 AuraAssetRef<"navigation">,验证它的SHA-256哈希，并导入序列化的导航网格。
RecastNavMeshHandle 拥有查询、序列化和确定性清理。
rawModule 和 rawNavMesh 高级绕行有公共逃生口吗没有私有导入的操作。

运行 pnpm exec vitest run tests/unit/navigation-recast 对于生成，查询，序列化、生命周期和可选边界测试。浏览器和工作器证据是在放行前由导航烘烤产生的。

@aura3d/navigation-recast 共发布 33 个版本，首次发布于 2026/08/13；过去 12 个月发布了 33 个版本。

可选的Aura3D异步初始化重铸/绕行导航适配器。

在项目目录运行 npm install @aura3d/navigation-recast，或使用 pnpm add / yarn add / bun add。

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

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

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

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