用途:该技能面向 Three.js 场景中的用户交互实现,包括点击检测、相机控制、对象选择与拖拽、悬停反馈、键盘移动以及坐标转换。
主要能力:
- 射线检测:使用 THREE.Raycaster 与 setFromCamera 实现鼠标拾取,intersectObjects 返回 distance、point、face、object、uv、normal、instanceId 等信息;支持 near/far 裁剪、Line/Points 阈值与 layers 过滤。
- 鼠标与触摸输入:将 clientX/clientY 归一化为 -1 到 1 的坐标,支持全窗口或指定 canvas;touchstart 处理单指触摸。
- 相机控制器:OrbitControls(阻尼、旋转/缩放/平移限制、自动旋转、target)、FlyControls、FirstPersonControls、PointerLockControls、TrackballControls、MapControls、TransformControls(translate/rotate/scale、local/world、dragging-changed 事件)、DragControls。
- 选择系统:点击选中并高亮、SelectionBox 与 SelectionHelper 框选、悬停变色与光标切换。
- 键盘输入:keydown/keyup 记录按键状态驱动移动。
- 坐标转换:worldToScreen、screenToWorld、射线与平面求交。
使用方式:从 three 与 three/addons 导入所需模块,创建 Raycaster 与 Vector2,在事件回调中更新鼠标坐标并调用 setFromCamera,再对目标对象数组执行 intersectObjects;控制器需在动画循环中调用 update(),带阻尼或自动旋转时尤其必要。
适用场景:3D 编辑器、模型查看器、游戏化界面、数据可视化中的对象拾取与相机漫游。
限制:资料未提供安装命令、版本要求、收费与平台信息;性能建议包括节流 mousemove、使用 layers、以简单碰撞网格替代复杂模型、不需要时禁用控制器。