3D 编辑器 · 快速入门指南¶
醒空 3D 编辑器的设计初衷，是打破传统 3D 开发的高技术壁垒。我们不希望您被复杂的代码和参数劝退，而是希望您能享受创作的乐趣。
文档将带您快速熟悉醒空 3D 编辑器的核心界面与操作逻辑。无论您是初次接触 3D 创作，还是有经验的开发者，都能通过本指南快速上手。
🚀 一、初始大厅：创作的起点¶
登录编辑器后，您将看到简洁的工程管理界面，这里包含三个核心入口：
-
🆕 新增课程
- 作用：开启一个新的创作项目。
- 方式：支持从"空白场景"从零开始，或选择"现有模板"快速复用。
-
📂 课程工程
- 作用：您的"草稿箱"。
- 说明：所有编辑中、未发布的存档都在这里。点击即可继续上次的工作。
-
☁️ 我的发布课程
- 作用：您的"成品库"。
- 说明：展示所有已发布上线的课程，供查看和管理。
🖥️ 二、工作台详解：四大核心区域¶
进入课程编辑界面后，整个屏幕即您的"3D 影棚"。为了方便理解，我们将界面划分为四个功能区：
1️⃣ 左侧：补给仓库 (资源与功能)¶
这里是您获取创作素材和功能组件的源头。
- 📦 素材库：包含系统预置的标准模型（如人物、建筑），也包含您上传的自定义素材。
- 🧩 组件库：提供功能性的积木，如 UI 按钮、视频播放器、倒计时等。
- ⚙️ 插件区：高级功能的入口，如弹道显示、模型拆解等（初学者可暂缓探索）。
- 🤖 AI 助手：您的"数字军火库"与"灵感参谋"。内嵌强大的 AIGC 引擎。当您缺少模型、贴图、配音或策划灵感时，点击此处即可唤起助手，现场生成所需的创作资源，实现"缺什么，造什么"。
- 🧠 逻辑元 (剧本编辑器)：场景的"大脑"。点击此处打开可视化逻辑面板。您不需要写代码，而是通过"触发条件 + 执行行为"的积木式组合，像导演写剧本一样定义场景的交互规则（如：按下按钮 → 播放报警声）。
2️⃣ 中间：导演中心 (结构管理)¶
这里决定了课程的结构和逻辑流。
- 🎬 章节管理：相当于剧本的"幕"。您可以新建多个章节，串联成一个完整的故事（如：前台接待 → 展厅讲解 → 考核结束）。
- 🗂️ 资源目录：项目的"文件夹"。从左侧选中的素材会先添加到这里，支持右键新建文件夹分类管理。
- 🌲 场景元素 (Hierarchy)：当前场景里有什么？所有被拖入 3D 世界的物体（实体）都会在这里列出。
3️⃣ 右侧：施工现场 (视窗与属性)¶
这是您进行可视化操作和精细调整的地方。
- 👀 3D 可视化编辑区：占据屏幕最大的区域。您可以在这里所见即所得地拖拽物体、调整位置、预览效果。
- 📝 实体属性配置栏：当您在场景中选中一个物体时，这里会显示它的详细参数（如坐标、大小、是否可抓取、绑定的逻辑等）。
4️⃣ 顶部：工具腰带 (基础操作)¶
提供最常用的操作指令。
- 🛠️ 基础工具：移动、旋转、缩放、视角重置等。
- ▶️ 试玩/发布：随时预览当前效果，或将作品发布上线。
🛠️ 三、新手创作六步走（核心工作流）¶
在完成创作策划后，使用 3D 编辑器进行环境/场景搭建的核心工作流如下：
课程创建启动¶
优先通过两种方式开启创作以提升效率：
- 方式一：直接创建全新课程（空白画板）。
- 方式二：使用已有模板创建课程（站在巨人的肩膀上）。
- 选择对应方式后，即可进入编辑器核心编辑面板。
章节框架搭建¶
进入编辑面板后，首先根据策划需求创建对应的章节。
- 原则：每个章节对应一个独立事件或场景。
- 目标：搭建好完整的课程骨架，为后续填充内容奠定基础。
素材准备与归拢（关键步骤）¶
场景搭建的前提是"米"，即素材。当前版本素材来源多样，核心是将它们汇总至"资源工作区"：
- A. 已有素材：通过模型转换工具 (Model Converter) 转换后放入工作区。
- B. AIGC 生成素材：可在策划阶段一次性生成，也可在使用中反复生成。生成后会自动拷贝至工作区，实现 AI 与人的操作上下文协同。
- C. 素材库素材：包含系统内置及用户存量素材。若有反复使用的素材，推荐从公共区拷贝。
- ⚠️ 管理规范：素材需按类型归拢至工作区对应目录（如图片归图片目录、模型归模型目录），确保分类清晰、调用便捷。
场景元素添加与布局¶
- 动作：从"工作区"或"素材库"选择所需素材，将其拖拽至对应章节的场景中，转化为"场景元素"。
- 调整：通过右侧 3D 场景可视化编辑区的拖拽操作，将场景元素调整至合适位置。
实体属性配置与保存¶
- 配置：选中场景中的场景元素（实体）后，通过右侧的"实体属性配置栏"配置各类属性（如是否参训、物理碰撞等）。
- 固化：完成后点击保存，该场景元素及对应属性将被固定。
场景搭建收尾与后续衔接¶
- 收尾：完成所有章节的场景元素布局与属性配置后，场景搭建（布景）部分即完成。
- 下一步：点击左侧 [逻辑元] 进入剧本编辑器，开展课程交互逻辑的编写工作。
💡 提示： 在基础编辑阶段，请重点掌握 "课程创建 → 章节搭建 → 素材归拢 → 场景布局 → 属性配置" 这一核心闭环。若需添加仿真功能，可调用左侧组件库或插件区的对应功能（如弹道轨迹、行进轨迹等），进阶功能可在熟悉基础操作后逐步学习使用。