threejs-product-viewer

产品查看器与配置器

使用项目已安装的版本和现有架构。这些说明是对用户任务的补充，不代表可以进行无关更改或外部操作。

检查模型的网格／材质名称、单位、变体结构、摄像机目标和业务选项。建立从产品选项到渲染变化的稳定映射，不要将 UI 标签与任意网格数组位置绑定。

为所选选项、可用性、重置以及任何 URL 持久化建立状态模型。价格／可用性应以现有应用数据层为准。不要从模型推断商业信息。提供语义等效的 HTML 控件和所选值摘要。

在实例自有的材质状态上应用变体，同时安全地共享不可变纹理。对异步纹理／模型切换进行防护，避免过时操作完成后覆盖当前状态。针对宽屏和窄屏布局调整每个预设的取景；仅在保证主体仍清晰可用所需的范围内限制轨道旋转／缩放。

使用稳定锚点放置热点，并处理遮挡／位于摄像机后方的状态。提供视图重置功能，并明确告知用户如何退出拖动操作。在添加会遮蔽产品细节的戏剧性效果前，先在受控光照下调整材质。

对于截图，应以指定的捕获尺寸进行渲染，并在之后恢复渲染器／摄像机状态。请在渲染后立即捕获，或使用合适的目标／读取回传流程；并非所有场景都需要 preserveDrawingBuffer。处理跨域限制，并决定导出内容是否包含 HTML 叠加层。

验证所有有效选项组合或具有代表性的边界组合、快速切换、重置、深层链接、导出取景、移动端控件和资源加载失败情况。

API 参考

有关准确的函数签名和特定版本的行为，请参阅官方文档。如果无法访问文档，请检查已安装的类型定义／源代码，并说明任何尚未确定之处。