360全景模块是 SX-Creval 系统中用于打造沉浸式数字展厅的核心组件。它可以将您的企业总部、工厂车间、样板间或大型展会现场 1:1 搬到线上。用户可以通过鼠标拖拽或手机滑动，720度无死角地查看空间细节。
该模块不仅支持全景漫游，还内置了极具科技感的交互系统（如发光热点、悬浮信息框、底部场景缩略图等），是外贸企业展示硬实力、提升客户信任度的绝佳工具。
智能演示模式：当您刚把该模块添加到页面中，尚未上传任何图片时，系统会自动播放内置的“工厂装配线”演示数据。这样您可以直观地预览效果，再开始替换自己的内容。
1. 核心概念解析
在开始配置之前，您只需要理解两个像“搭积木”一样的基础概念：
- 场景 (Scene)：代表一个独立的空间。例如：“一楼接待大厅”是一个场景，“二楼生产车间”是另一个场景。您可以创建无数个场景。
- 热点 (Hotspot)：悬浮在三维空间中的互动按钮。用户点击热点后，可以弹出一个产品介绍框，或者像“任意门”一样直接传送到另一个场景。
2. 模块配置指南
2.1 总体设置 (View360)
- 默认显示的场景ID：当客户打开网页时，第一眼看到的空间是哪个。请填写下方场景列表中某一个场景的“场景ID”。如果不填，系统默认展示列表中的第一个场景。
- 场景列表：点击“添加全景场景”，开始搭建您的空间。
2.2 场景设置 (Scene Block)
针对每一个独立的空间，您需要配置以下信息：
- 场景ID：该空间的唯一身份证明。仅限使用英文字母和数字（例如：showroom、factory01）。这个ID非常重要，后续设置“场景切换”时会用到它。
- 场景名称：空间的显示名称（例如：产品展示中心）。它会显示在底部的缩略图和界面的左上角。
- 全景图：上传您的360度全景照片。
- 尺寸建议：长宽比必须严格为 2:1。
- 分辨率建议：宽度建议在 4096 像素到 5000 像素之间，以保证高清画质。（无需担心图片太大导致网页卡顿，SX-Creval 系统在后台会自动将超大图片进行切片和 WebP 极致压缩，保证秒开体验）。
2.3 热点设置 (Hotspot Block)
在场景中，您可以添加多个“热点”。热点分为两种类型：
类型一：信息弹窗 (Info Modal)
用于在空间中介绍某台设备或某款产品。
- 提示文字/弹窗标题：悬停在发光点上显示的短文字，以及弹出框的大标题。
- 弹窗描述文字：详细的产品或设备介绍。
- 弹窗图片：介绍配图。系统会自动将其裁剪压缩为适合弹出框的高清小图。
类型二：切换场景 (Scene Transition)
用于空间漫游，引导客户走向下一个房间。
- 提示文字：例如“进入生产车间”。
- 目标场景ID：填写您想要客户前往的那个“场景ID”（例如：factory01）。
3. 独家高级功能：如何获取热点的 3D 坐标？
配置热点时，系统会要求您输入俯仰角 (Pitch) 和 偏航角 (Yaw)，这决定了热点在全景图中的准确悬浮位置。
在传统系统中，这需要复杂的代码计算，但在 SX-Creval 中，只需两步即可完成：
- 进入预览模式：在 Wagtail 后台编辑好全景图并保存后，点击页面右侧的【预览】按钮。
- 点击取点：在预览界面中，用鼠标转动全景图到您想要放置热点的位置，直接点击该位置。
- 一键复制：此时，屏幕正上方会自动弹出一个黑色的“坐标拾取器”，显示精确的 Pitch 和 Yaw 数值。点击这个黑色框，数值会自动复制到您的剪贴板，直接粘贴到后台的输入框中即可。
4. 前端用户体验说明
SX-Creval 为 360 全景模块配备了极具现代感的交互界面：
- 自动巡航：页面加载后，全景图会自动缓慢旋转，展示整个空间。
- 右侧快捷控制台：包含一键拨打电话、发送邮件、放大/缩小、暂停/播放旋转等功能图标。采用毛玻璃半透明材质，不遮挡视线。
- 底部场景漫游栏：屏幕底部会自动生成所有场景的缩略图列表。在电脑端支持鼠标拖拽，在手机端支持手指平滑滑动。点击缩略图即可瞬间切换空间。系统会自动从您上传的超大原图中截取并生成极小体积的缩略图，完全不消耗额外流量。
- 沉浸式 HUD 弹窗：当客户点击“信息弹窗”热点时，右下角会平滑升起一个设计精美的毛玻璃信息面板，展示产品图文细节，背景全景图会自动停止旋转以保持阅读专注。