SuperAPI AI 工具集

threejs-interaction

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:该技能面向 Three.js 场景中的用户交互实现,包括点击检测、相机控制、对象选择与拖拽、悬停反馈、键盘输入以及坐标转换。

主要能力:

  1. 射线检测:使用 THREE.Raycaster 从相机或任意原点发射射线,通过 setFromCamera 或 set 设置,intersectObjects 获取交点信息(distance、point、face、object、uv、normal、instanceId 等)。支持 near/far 裁剪、Line/Points 阈值、layers 过滤。
  2. 鼠标与触摸输入:将 clientX/clientY 转换为归一化设备坐标(-1 到 1),支持全窗口或指定 canvas 元素;touchstart 处理单指触摸选择。
  3. 相机控制器:OrbitControls(阻尼、旋转/缩放/平移限制、自动旋转、target)、FlyControls、FirstPersonControls、PointerLockControls、TrackballControls、MapControls、TransformControls(移动/旋转/缩放 gizmo)、DragControls(直接拖拽对象)。
  4. 选择系统:点击选择(高亮 emissive)、框选(SelectionBox 与 SelectionHelper)、悬停效果(颜色变化与光标样式)。
  5. 键盘输入:keydown/keyup 记录按键状态,驱动移动。
  6. 坐标转换:worldToScreen、screenToWorld、射线与平面求交(ray.intersectPlane)。

使用方式:通过 import 从 "three" 与 "three/addons/controls/..." 引入对应模块,创建控制器或 Raycaster 实例,绑定事件监听,并在动画循环中调用 controls.update()(阻尼与自动旋转需要)。

适用场景:3D 网页中的对象拾取、编辑器 gizmo、第一人称漫游、地图浏览、拖拽布局等。

限制:资料未提供具体版本要求、浏览器兼容性、性能基准或收费信息;射线检测需注意节流与使用简化碰撞网格以优化性能。