元素类型详解
艾克斯场景编辑器提供 37 种场景元素，本节详细介绍每种元素的功能、属性和使用场景。
元素分类总览
| 分类 | 元素数量 | 包含元素 |
|---|---|---|
| 基础对象 | 3 | Group, Spawn Point, Scene Preview Camera |
| 3D 模型与媒体 | 4 | Model, Image, Video, Kit Piece |
| 灯光 | 5 | Ambient, Directional, Point, Spot, Hemisphere |
| 交互与逻辑 | 7 | Trigger Volume, Switch, Way Point, Patrol Route, Spawner, Media Frame, Link |
| 音频 | 3 | Audio, Audio Zone, Audio Params |
| 环境 | 4 | Skybox, Ground Plane, Floor Plan, Simple Water |
| 界面与特殊 | 11 | Mirror, Troika Text, Web Frame, Shared Screen, Empty Frame, Inline View, Box Collider, Particle Emitter |
一、基础对象
1. Group (组)
功能：将多个元素组合在一起管理
使用场景：
- 组织复杂场景的结构
- 批量移动/变换多个元素
- 创建可复用的组件
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Name | 组名称 | "Group" |
| Visible | 是否可见 | true |
| Enabled | 是否启用 | true |
使用方法：
- 选择多个元素
- 右键 → Group (Ctrl+G)
- 组会包含所有选中元素作为子元素
注意事项：
- 子元素继承父组的变换
- 删除组会同时删除所有子元素
- 可以嵌套组（组中套组）
2. Spawn Point (出生点)
功能：定义用户进入场景时的初始位置
使用场景：
- 设置场景入口位置
- 控制用户初始朝向
- 多出生点场景
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Position | 出生位置 | (0, 0, 0) |
| Rotation Y | 水平朝向角度 | 0° |
最佳实践：
- 每个场景至少有一个出生点
- 出生点应放在空旷、易于导航的位置
- 可以放置多个出生点，系统会随机选择
3. Scene Preview Camera (场景预览相机)
功能：设置场景缩略图的相机角度
使用场景：
- 设置项目缩略图视角
- 展示场景最佳角度
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Position | 相机位置 | (0, 1.6, -3) |
| Rotation | 相机旋转 | (0, 0, 0) |
使用方法：
- 添加 Scene Preview Camera 到场景
- 调整位置和角度
- 发布时会使用该视角生成缩略图
二、3D 模型与媒体
4. Model (模型)
功能：加载和显示 GLTF/GLB 格式的 3D 模型
支持的格式：
- GLTF (.gltf)
- GLB (.glb)
- OBJ (.obj) - 自动转换
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Source | 模型文件 URL | - |
| Attribution | 作者署名 | - |
| Cast Shadow | 投射阴影 | true |
| Receive Shadow | 接收阴影 | true |
| Static | 静态模式 | true |
使用方法：
- 从资源面板拖拽模型
- 或使用 File → Import 导入本地模型
- 调整位置、旋转、缩放
性能提示：
- 静态模型会自动合并以优化性能
- 大型模型建议压缩后再导入
- 使用纹理图集减少 draw call
5. Image (图片)
功能：在场景中显示平面图片
支持的格式：
- JPG/JPEG
- PNG
- GIF (静态)
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Source | 图片 URL | - |
| Projection | 投影方式 | Flat |
| Controls | 是否显示控制 | true |
| BillBoard | 是否始终面向相机 | false |
投影方式：
| 方式 | 说明 |
|---|---|
| Flat | 平面投影 |
| Equirectangular | 等距圆柱投影（360°图片） |
使用场景：
- 海报、画作
- 信息展示牌
- 360°环境背景
6. Video (视频)
功能：在场景中播放视频
支持的格式：
- MP4
- WebM
- 外部视频链接
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Source | 视频 URL | - |
| Projection | 投影方式 | Flat |
| Auto Play | 自动播放 | false |
| Controls | 显示播放控制 | true |
| Loop | 循环播放 | true |
| Volume | 音量 | 0.5 |
使用场景：
- 信息展示屏
- 动态背景
- 艺术装置
7. Kit Piece (套件组件)
功能：从 Kit 库中放置预制组件
常用 Kit：
- Architecture Kit (建筑套件)
- Rock Kit (岩石套件)
- Nature Kit (自然套件)
属性：
| 属性 | 说明 |
|---|---|
| Kit Id | 套件 ID |
| Piece Id | 组件 ID |
使用方法：
- 在资源面板选择 Kit 来源
- 浏览套件中的组件
- 拖拽组件到场景
三、灯光
8. Ambient Light (环境光)
功能：均匀照亮整个场景，无方向性
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Color | 光颜色 | #ffffff |
| Intensity | 强度 | 1.0 |
使用建议：
- 作为基础照明，提供最低亮度
- 强度不宜过高，通常 0.2-0.5
- 配合其他光源使用
9. Directional Light (定向光)
功能：模拟太阳光，平行光线，有方向性
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Color | 光颜色 | #ffffff |
| Intensity | 强度 | 1.0 |
| Cast Shadow | 投射阴影 | true |
| Shadow Map Size | 阴影贴图大小 | 2048 |
| Shadow Bias | 阴影偏移 | -0.0001 |
使用建议：
- 作为场景主光源
- 调整角度模拟不同时间的阳光
- 开启阴影增加真实感
10. Point Light (点光源)
功能：从一点向四周发光，如灯泡
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Color | 光颜色 | #ffffff |
| Intensity | 强度 | 1.0 |
| Range | 影响范围 | 10 |
| Cast Shadow | 投射阴影 | false |
使用场景：
- 室内灯具
- 发光装饰
- 氛围照明
11. Spot Light (聚光灯)
功能：锥形光束，如手电筒、舞台灯
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Color | 光颜色 | #ffffff |
| Intensity | 强度 | 1.0 |
| Range | 影响范围 | 10 |
| Angle | 锥角 | 60° |
| Penumbra | 半影（边缘柔化） | 0.2 |
| Cast Shadow | 投射阴影 | false |
使用场景：
- 重点照明
- 舞台效果
- 手电筒模拟
12. Hemisphere Light (半球光)
功能：天空/地面颜色渐变，模拟环境光
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Sky Color | 天空颜色 | #ffffff |
| Ground Color | 地面颜色 | #444444 |
| Intensity | 强度 | 1.0 |
使用建议：
- 作为环境光的补充
- 天空色偏蓝，地面色偏棕/绿
- 强度较低时效果更佳
四、交互与逻辑
13. Trigger Volume (触发器)
功能：检测用户进入/离开特定区域
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Size | 触发区域大小 | (1, 1, 1) |
| Enter Distance | 进入触发距离 | 0 |
| Leave Distance | 离开触发距离 | 0 |
| Target | 目标对象 | - |
使用场景：
- 区域进入检测
- 触发音频/动画
- 游戏逻辑
14. Switch (开关)
功能：可切换状态的控制器，控制其他元素
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Target | 目标对象 | - |
| State | 初始状态 | Off |
使用场景：
- 灯光开关
- 门控制
- 交互式装置
15. Way Point (路径点)
功能：导航点，用户可点击传送；也可作为 AI 智能体的巡航停靠点
基础属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Can Be Spawn Point | 可作为出生点 | false |
| Can Be Occupied | 可被占据 | false |
| Can Be Clicked | 可点击传送 | false |
| Will Disable Motion | 传送后禁用移动 | false |
| Will Disable Teleporting | 传送后禁用传送 | false |
| Snap To Nav Mesh | 吸附到导航网格 | false |
| Will Maintain Initial Orientation | 保持传送前朝向 | false |
| 姿态类型 | 传送后的姿态 | 站立 |
巡航属性（开启「巡航停靠点」后显示）：
| 属性 | 说明 | 默认值 |
|---|---|---|
| 巡航停靠点 | 标记此路径点为 AI 巡航停靠站 | false |
| 巡航顺序 | 在巡航路线中的停靠顺序（0, 1, 2...） | 0 |
| 触发关键词 | 智能体到达此处时用于知识库检索的关键词 | "" |
使用场景：
- 快速移动点 / 场景导航 / 观景点标记
- AI 智能体巡航路线的停靠站（开启「巡航停靠点」后）
- 为每个停靠点设置不同的知识关键词，实现场景导览解说
巡航停靠点说明：
开启「巡航停靠点」后，该路径点会被 Patrol Route（巡航路线）引用。智能体在巡航时会按顺序到达每个停靠点，停留一段时间后前往下一站。属性面板下方还会显示「知识文件」区域，用于管理与此停靠点关联的知识库文档。
- 巡航顺序：决定智能体到达各停靠点的先后次序（数字越小越先到达）
- 触发关键词：智能体到达停靠点后，系统会用此关键词在知识库中检索相关内容，智能体基于检索结果进行解说
16. Patrol Route (巡航路线)
功能：定义 AI 智能体的巡航路线，让智能体在场景中按序巡逻并解说
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| 路线名称 | 巡航路线的名称标识 | "" |
| 循环路线 | 到达最后一站后回到第一站继续巡航 | true |
| 最短停留时间（秒） | 智能体在每个停靠点最短停留的秒数 | 5 |
| 最长停留时间（秒） | 智能体在每个停靠点最长停留的秒数 | 10 |
| 分配角色 | 使用此巡航路线的智能体角色类型 | 智能导览 |
| 触发关键词 | 用户说出关键词时激活巡航，多个关键词用「、」分隔 | "" |
| 巡航停靠点 | 此路线包含的路径点列表（可拖拽排序） | - |
巡航停靠点列表：
选中路线后，属性面板显示已添加的停靠点列表，支持以下操作：
- 添加巡航点：从下拉菜单选择已有的 Way Point 添加到路线
- 拖拽排序：拖动停靠点条目左侧的 ≡ 图标调整顺序
- 设置关键词：每个停靠点可单独设置叙述触发词
- 移除停靠点：点击 × 按钮将停靠点从路线中移除
- 预览路线：点击「开始预览」在视口中沿路线动画展示标记
使用场景：
- 虚拟展厅导览：智能体按路线讲解各展品
- 场景介绍：智能体在关键位置停留并解说
- 互动导览：用户说"开始导览"触发智能体沿路线巡逻
创建巡航路线的步骤：
- 在场景中放置多个 Way Point 元素，在各自的属性面板中开启「巡航停靠点」
- 添加 Patrol Route 元素到场景
- 在路线属性中点击「添加巡航点」，依次选择要加入的路径点
- 为路线设置触发关键词（如"导览"、"讲解"）
- 拖拽调整停靠点的巡航顺序
- 点击「开始预览」验证路线是否合理
- 确保场景中有 Floor Plan 元素以提供导航网格
路线可视化：
选中 Patrol Route 后，编辑器会在视口中显示路线可视化：
- 绿色虚线：可通行的路径段（基于导航网格）
- 红色虚线：不可通行的路径段（跨导航网格组）
- 数字标签：标注每个停靠点的顺序编号
- 箭头标记：指示路线方向
注意事项：
- 巡航路线需要 Floor Plan 导航网格才能在 Hubs 中正常运作
- 添加路径点时会自动将其「巡航停靠点」属性设为 true
- 路线中的路径点顺序由列表排列决定，与 Way Point 的「巡航顺序」属性独立
- 循环路线模式下，智能体到达最后一站后会返回第一站继续巡航
- 非循环路线模式下，智能体到达最后一站后停止巡航
17. Spawner (生成器)
功能：动态生成对象
属性：
| 属性 | 说明 |
|---|---|
| Source | 生成对象的模型 |
| Spawn Rate | 生成频率 |
| Max Objects | 最大对象数 |
使用场景：
- 动态场景元素
- 游戏机制
- 交互反馈
18. Media Frame (媒体框)
功能：固定媒体展示区域，可放置图片/视频/模型
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Size | 框架大小 | (1, 1, 0.1) |
| Bounds | 边界框 | - |
| Snap To Center | 媒体居中 | true |
| Media Type | 允许的媒体类型 | All |
使用场景：
- 展示墙
- 画廊
- 信息展示区
19. Link (链接)
功能：可点击的传送门，跳转到其他场景
属性：
| 属性 | 说明 |
|---|---|
| URL | 目标场景 URL |
| Title | 链接标题 |
使用场景：
- 场景间跳转
- 外部链接
- 导览路径
五、音频
20. Audio (音频源)
功能：播放背景音乐或音效
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Source | 音频文件 URL | - |
| Auto Play | 自动播放 | false |
| Loop | 循环播放 | false |
| Volume | 音量 | 0.5 |
| Rolloff Mode | 距离衰减模式 | Linear |
| Rolloff Factor | 衰减因子 | 1.0 |
| Max Distance | 最大距离 | 20 |
| Ref Distance | 参考距离 | 1.0 |
距离衰减模式：
| 模式 | 说明 |
|---|---|
| Linear | 线性衰减 |
| Inverse | 反比衰减 |
| Exponential | 指数衰减 |
21. Audio Zone (音频区域)
功能：空间化音频区域，进入区域改变音频
属性：
| 属性 | 说明 |
|---|---|
| Size | 区域大小 |
| Target | 目标音频源 |
| Gain | 区域内增益 |
22. Audio Params (音频参数)
功能：全局音频设置
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Master Gain | 主音量 | 1.0 |
| Distortion | 失真 | 0 |
| Low Pass | 低通滤波 | 0 |
六、环境
23. Skybox (天空盒)
功能：360° 环境背景
属性：
| 属性 | 说明 |
|---|---|
| Source | 全景图 URL (equirectangular) |
| Color | 纯色背景 |
使用场景：
- 室外场景背景
- 氛围营造
24. Ground Plane (地面)
功能：无限延伸的地面平面
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Color | 地面颜色 | #444444 |
| Receive Shadow | 接收阴影 | true |
25. Floor Plan (楼层平面)
功能：自动生成导航网格
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Auto Cell Size | 自动单元格大小 | true |
| Cell Size | 单元格大小 | 0.1 |
| Cell Height | 单元格高度 | 0.1 |
| Agent Height | 代理高度 | 1.7 |
| Agent Radius | 代理半径 | 0.2 |
| Agent Max Climb | 最大攀爬高度 | 0.5 |
| Agent Max Slope | 最大坡度 | 45° |
使用建议：
- 放在场景底部
- 自动分析场景几何体生成导航网格
- 用户可以在导航网格上移动
26. Simple Water (简单水面)
功能：基础水面效果
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Color | 水颜色 | #0044ff |
| Opacity | 不透明度 | 0.8 |
七、界面与特殊
27. Mirror (镜子)
功能：反射效果
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Width | 宽度 | 2 |
| Height | 高度 | 3 |
28. Troika Text (文字)
功能：3D 文字
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Text | 文本内容 | "Text" |
| Font Size | 字体大小 | 0.1 |
| Color | 颜色 | #ffffff |
| Anchor X | X 锚点 | center |
| Anchor Y | Y 锚点 | middle |
29. Web Frame (网页框)
功能：嵌入网页
属性：
| 属性 | 说明 |
|---|---|
| URL | 网页地址 |
| Width | 宽度 |
| Height | 高度 |
30. Shared Screen (共享屏幕)
功能：屏幕共享区域
属性：
| 属性 | 说明 |
|---|---|
| Width | 宽度 |
| Height | 高度 |
31. Empty Frame (空框)
功能：占位容器
属性：
| 属性 | 说明 |
|---|---|
| Size | 大小 |
32. Inline View (内联视图)
功能：画中画视图
属性：
| 属性 | 说明 |
|---|---|
| Source | 源对象 |
| Size | 大小 |
33. Box Collider (盒碰撞体)
功能：定义碰撞区域
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Size | 碰撞盒大小 | (1, 1, 1) |
34. Particle Emitter (粒子发射器)
功能：粒子效果
属性：
| 属性 | 说明 | 默认值 |
|---|---|---|
| Particle Size | 粒子大小 | 0.1 |
| Particle Speed | 粒子速度 | 1.0 |
| Particle Life | 粒子寿命 | 1.0 |
| Emission Rate | 发射率 | 10 |
| Color | 颜色 | #ffffff |
元素选择速查表
| 需求 | 推荐元素 |
|---|---|
| 展示 3D 模型 | Model |
| 显示图片 | Image |
| 播放视频 | Video |
| 基础照明 | Ambient Light |
| 主光源 | Directional Light |
| 局部照明 | Point Light / Spot Light |
| 背景音乐 | Audio |
| 空间音频 | Audio Zone |
| 用户出生位置 | Spawn Point |
| 场景传送 | Way Point / Link |
| AI 巡航路线 | Patrol Route |
| 交互触发 | Trigger Volume |
| 开关控制 | Switch |
| 展示墙 | Media Frame |
| 3D 文字 | Troika Text |
| 导航网格 | Floor Plan |
| 碰撞检测 | Box Collider |
| 粒子效果 | Particle Emitter |
| 网页嵌入 | Web Frame |
| 屏幕共享 | Shared Screen |