SuperAPI AI 工具集

threejs-capacitor-ios

设计与创作

查看项目

更新于 10-15 20:12

技能介绍

用途:帮助把 Three.js 交互应用同时运行在浏览器与 Capacitor iOS 原生壳中,重点解决网页构建产物、动画契约、控制器映射与原生同步运行之间的集成边界问题。

主要能力:以 Vite 构建网页端,静态资源放在 public/ 下用绝对路径(如 /assets/...)加载;用 assets_index.json 作为动画唯一数据源,记录骨骼 URL、动画源 URL 及 animations[] 条目(稳定 app id、sourceClipName、循环模式与默认值),运行时按 sourceClipName 解析按钮对应片段并建立 AnimationAction 映射;显式设置 OrbitControls 映射,鼠标左键旋转、滚轮缩放、右键平移,触摸单指旋转、双指缩放加平移;性能上限制像素比 Math.min(devicePixelRatio, 2),复用 mixer/actions,resize 时更新相机与渲染器。

使用方式: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。Capacitor 8+ 默认用 SPM,已有 CocoaPods 项目需有意迁移。

适用场景:角色展示、玩法原型、资源 QA 工具等,可按产品意图调整光照、阻尼、动画切换与 UI。

限制与注意:避免在 UI 处理器中硬编码片段名、混用 SPM 与 CocoaPods 假设、未重新构建网页资源就运行 iOS、隐式控制映射,以及先调试原生而忽略网页契约错误。资料未提供具体收费、价格与平台支持范围。