用途:帮助开发者把 Three.js 交互应用同时运行在浏览器与 Capacitor iOS 原生外壳中,重点解决网页构建产物、动画契约、控制器与原生同步运行之间的集成边界问题。
主要能力:以 Vite 构建 Three.js 应用,静态资源放在 public/ 下用绝对路径加载;用 assets_index.json 作为动画唯一数据源,记录骨骼 GLB、动画 GLB 及 animations[] 条目(稳定 app id、sourceClipName、循环模式与默认值),运行时按 id 建立 AnimationAction 映射并播放默认动作;显式配置 OrbitControls 的鼠标(左键旋转、滚轮缩放、右键平移)与触摸(单指旋转、双指缩放加平移)映射;iOS 默认使用 Swift Package Manager(Capacitor 8+),必要时再迁移到 CocoaPods。
使用方式:npm run build 构建,capacitor.config.ts 中设 webDir: "dist",用 npx cap add ios --packagemanager SPM 添加 iOS 平台;日常循环为 npm run build、npx cap sync ios、npx cap run ios 或 npx cap open ios。原生或插件变更后需再次 sync。
适用场景:角色展示、玩法原型、资源 QA 工具等,可按产品意图调整光照、阻尼、动画切换与 UI。
限制与注意:避免硬编码动画名、混用 SPM 与 CocoaPods、未重新构建就运行 iOS、隐式控制映射;建议限制像素比、复用 mixer/action、resize 时更新相机与渲染器。具体命令细节见技能内 references 文档,官方未提供更多收费或平台信息。