SuperAPI AI 工具集

r3f

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

用途:在 React 中用 JSX 声明式搭建 Three.js 3D 场景,React 负责场景图(挂载、卸载、协调 JSX→Three.js 对象),Three.js 负责渲染循环(useFrame 逐帧直接改 refs)。补充命令式 threejs 技能;当项目为 React + JSX 且涉及 3D 时使用本技能,材质、灯光、阴影概念与 threejs 技能通用。

主要能力:Canvas 与 useThree、useFrame、useLoader、useGraph 等 hooks;JSX 到 Three.js 的映射、args、attach、extend、primitive 与事件;drei 的 OrbitControls、CameraControls、PivotControls、TransformControls 等控件;Environment、阴影、Sky 等布景;Text、Html、Billboard、loaders 与动画;Bvh、Instances、LOD、PerformanceMonitor、FBO 等性能手段;Zustand 桥接(getState、invalidate、按需渲染);@react-three/csg 与 three-bvh-csg 布尔运算;TypeScript v9 类型与迁移。

使用方式:通过学习路径 references/01 到 10 的文档逐级掌握,从基础 Canvas 与 hooks 到 drei 生态、性能模式、Zustand 集成、CSG 与类型。核心规则包括:不要在 useFrame 中 setState;useThree 使用选择器;自定义对象需先 extend();加载器组件包裹 Suspense;静态场景用 frameloop="demand";args 作为常量或 useMemo;共享资源用 dispose={null};controls 加 makeDefault;primitive 不克隆;事件只绑在有 geometry 的 mesh 上。部署前检查含 dpr=[1,2]、Bvh 包裹等。命令与示例保持原样,如 new THREE.Vector3()、useThree(s => s.camera)、<Canvas shadows camera={{ position: [3, 3, 3], fov: 50 }}>、OrbitControls makeDefault、Environment preset="studio"。

适用场景:React 项目内的 3D 可视化、可交互模型、产品展示等。

限制:具体安装命令、收费、价格、平台与效果资料暂未提供。