3D 模型

在全景中放置可交互 3D 模型的热点类型，支持弹窗展示或直接嵌入场景。

1. 页面信息

2. 功能说明

3. 业务说明

配置区域

面板顶部为「交互方式」切换（弹窗模型 / 嵌入场景）。弹窗模型方式下含模型文件、自动旋转、旋转速度、纯色背景/背景颜色、模型背景等；嵌入场景方式下含选择模型文件，以及「模型位置调整」「模型旋转调整」「模型缩放调整」「阴影与特效」四个折叠分区。底部按钮为「保存模型」。

字段说明

配置项 作用说明 类型/可选值 默认值/必填
交互方式 模型以弹窗还是直接嵌入场景的方式展示 切换：弹窗模型 / 嵌入场景 默认弹窗模型
模型文件 选择要展示的 3D 模型文件 素材库选择模型 必填
自动旋转 模型是否自动旋转（弹窗模型） 开关 默认开启
旋转速度 自动旋转的速度（弹窗模型） 数字输入 默认 0.5
纯色背景 弹窗模型是否使用纯色背景 开关 默认开启
背景颜色 纯色背景下的背景色 颜色选择器（支持透明度） 默认 #CCCCCC
模型背景 非纯色背景时选择一张全景图作为背景 素材库选择全景图 纯色背景关闭时可选
X轴位置(tx) / Y轴位置(ty) / Z轴位置(tz) 模型在场景中的位置（嵌入场景） 滑块 -500 ~ 500，步长 0.1 默认 0
X轴旋转(rx) / Y轴旋转(ry) / Z轴旋转(rz) 模型旋转角度（嵌入场景） 滑块 -180 ~ 180 默认 0
旋转顺序 模型旋转的应用顺序（嵌入场景） 下拉选择：YXZ（默认）/ XYZ / ZYX / ZXY / YZX / XZY 默认 YXZ
整体缩放 模型整体缩放比例（嵌入场景） 滑块 0.001 ~ 10 默认 1
单轴缩放 开启后分别设置 X/Y/Z 三轴缩放 开关 默认关闭
X轴缩放 / Y轴缩放 / Z轴缩放 各轴单独缩放比例（开启单轴缩放后） 滑块 0.001 ~ 5 默认 1
投射阴影 模型是否投射阴影（阴影与特效） 开关 默认开启
接收阴影 模型是否接收阴影（阴影与特效） 开关 默认开启

保存与生效

点击「保存模型」保存配置；保存成功会给出提示。配置会作用于编辑器预览，外部访问者需重新发布作品后可见。嵌入场景方式调整参数时会实时刷新场景中的模型。

4. 使用说明

  1. 在编辑器「热点设置」中选择 3D 模型
  2. 选择交互方式（弹窗模型或嵌入场景）
  3. 选择模型文件，弹窗模式可设置背景与自动旋转
  4. 嵌入场景时调整位置、旋转、缩放与阴影
  5. 点击「保存模型」并重新发布作品

5. 规则与限制

6. 状态与异常

7. 相关文档

8. 文档信息