一款桌灯的商品页需要展示灯罩材质和底座接口。先把目标写成用户可以完成的三个动作:从默认视角看整体,切换到接口特写,关闭查看器回到规格说明。准备一个简化模型、一张默认产品图、两张细节图,以及每个视角对应的文字说明。图片和规格应当在模型加载前可用,这样可以单独验收商品页和三维功能。
用 Three.js 验证相机和灯光
先在独立页面用一个立方体搭场景。设置渲染区域、透视相机、方向光与环境光,让一个模型在窗口缩放后仍然保持比例。检查容器实际宽高再更新相机的宽高比,避免在隐藏容器上初始化得到零尺寸。用固定背景和可见网格检查模型的朝向、原点和地面接触位置。旋转时让相机围绕目标移动,分别限制俯仰和缩放范围,避免用户把视角拖到灯罩里面。
交付一个能独立运行的小场景,记录相机位置、观察目标、近远裁剪面和默认视角。空白时先检查渲染区大小,再用简单几何体区分相机与模型加载问题。物体被裁切时核对包围盒、模型比例与裁剪面。每次只改一个变量,截图记录正常状态,方便接入页面后对照。
把场景接入 React Three Fiber
在已有 React 项目里,可以用 React Three Fiber 组织 Canvas、灯光和模型组件。外层页面负责打开、关闭、当前视角和加载错误;场景组件负责相机、光照、渲染与模型。重置按钮应同时恢复相机位置和控制目标。连续拖动所需的临时量留在控制器或引用中,避免每帧更新整个商品页。若页面已经使用原生 Three.js,也可以先封装现有查看器,再让 React 负责外层状态。
把等待、成功和失败作为三个可观察的状态。模型未就绪时保留静态图和加载提示;发生错误时显示重试入口与细节图。关闭后检查动画循环、事件订阅和渲染资源是否按组件生命周期释放。重复开关十次,观察是否积累监听器或多份画布。若采用 Drei 等辅助组件,先确认依赖兼容和资源生命周期,再决定是否使用相机控制或载入辅助。Frontend Design 用于规划外层布局、按钮、移动端状态和可访问名称,场景内部仍需检查三维运行结果。
整理模型、纹理和材质
让模型以清楚的单位和一致的轴向导出。先用几何简化版本确认构图,再加载带材质的 GLB 或 glTF。灯罩透明度、底座金属感和开关的粗糙度可分开检查。用固定光照对照产品参考图,分别判断色彩、反射和贴图是否符合预期。颜色不对时核查颜色纹理与非颜色数据的解释方式、色调映射和灯光,再改材质数值。
按用途拆分资产预算。默认模型只需支持整体和两处细节,不一定要带所有不可见零件。记录模型、纹理及解码器的传输大小和解码耗时。缩小纹理后在目标设备上检查边缘、文字和反射效果。上线前用实际部署地址验证所有依赖文件能加载,尤其是相对路径、缓存和跨域访问。资源版本变动时同步更新静态图、尺寸说明和可复现的验收样例。
实操验收:一盏桌灯的两处特写
首屏显示默认图和规格。点击“查看 3D”才请求模型,加载完成后切换到“接口”,检查相机指向底座。按“重置”恢复整体视角,关闭后焦点回到原按钮。再模拟一次模型请求失败,确认页面能读到接口图片和规格,重试时不会多建一块画布。用 Webapp Testing 记录打开、视角切换、关闭与失败恢复的可重复流程。相机角度和材质效果可补充基准截图,交互以用户实际能完成的动作来判断。
验收表还应包含首次加载和缓存命中两种情况。首次打开记录从点击到可控制的时间,再关闭并重开,确认第二次加载符合缓存预期。用键盘走完同样流程,检查控制按钮的焦点顺序,并确认读者即使跳过查看器也能获得接口尺寸。
常见问题
手机端旋转时页面不能滚动怎么办
将拖动范围限制在画布内,并保留关闭按钮和滚动空间。用真机检查一次纵向滚动和画布内拖动,必要时让用户先主动进入查看模式。只在桌面模拟窄屏无法覆盖系统手势与触屏行为。
桌面流畅,手机掉帧先查哪里
分别记录请求时间、模型解码和进入交互后的帧表现。调低渲染分辨率、缩小纹理或减少透明叠层时,每次仅修改一项。对比同设备同视角的结果,找出主要开销后再决定保留什么效果。
什么时候可以用静态图交付
如果规格、外观和接口都能用图片说明,静态路径可以先发布。把三维查看器当成可选增强,等验证它确实帮助用户理解某个结构,再扩展模型和交互。