yangbear
f0a6b96da5
- 删除重复 Ground - 创建 [Managers] 空物体，挂载 GameManager + StepManager + ExperimentFlowCoordinator + AudioManager - Main Camera 挂载 InteractionSystem - 伤者 InjectedPerson 下创建 5 个交互子物体 (InjuryVisual/Swelling/Pain/VitalSigns/Neuro) - 创建绑带位置、踝关节、衬垫、夹板位置等空物体 - 道具摆放到位：伤者(2,0.05,5) 施救者(3,0,5) 鞋(2.7,0.15,5.5) 绷带/夹板/急救箱在旁 - InjuryLeg Tag 修正，Ground Tag 修正 - 全部新脚本同步导入 (ExperimentTypes/StepData/ExperimentConfig/StepManager/GameManager/ExperimentFlowCoordinator/InteractionSystem/DraggableObject/HighlightEffect/UIManager/ExamPopup/ScoreDisplay/VideoController/AudioManager/CharacterAnimController/StepAnimationHandler) - 旧脚本 (ExperimentController/ConfigLoader/AnimationController/HUDController/VideoPlayerController/PopupSystem/ModeSelectionUI) 全部兼容修复或 stub - 编译通过，0 错误 - Canvas 挂载 UIManager
284 lines
10 KiB
Markdown
284 lines
10 KiB
Markdown
# VFSUnity - 运动伤害现场急救处理虚拟仿真实验
|
||
|
||
基于 Unity 2022.3.62f3c1 (URP) 的体育虚拟仿真教学项目。
|
||
|
||
## 环境要求
|
||
|
||
| 工具 | 版本 |
|
||
|------|------|
|
||
| Unity Editor | **2022.3.62f3c1**（必须一致，建议通过 Unity Hub 安装） |
|
||
| Unity Hub | 3.x+ |
|
||
| 渲染管线 | Universal Render Pipeline (URP) 14.0.12 |
|
||
|
||
## 快速开始
|
||
|
||
### 1. 克隆仓库
|
||
|
||
```bash
|
||
git clone https://git.yangbear.cn/yangbear/VFSUnity.git
|
||
```
|
||
|
||
### 2. 用 Unity Hub 打开
|
||
|
||
1. 打开 **Unity Hub**
|
||
2. 确保已安装 **Unity 2022.3.62f3c1**
|
||
3. 点击 **Open** → 选择 clone 下来的 `VFSUnity` 文件夹
|
||
4. Unity 自动加载并解析 `Packages/manifest.json` 中的依赖包
|
||
|
||
### 3. 运行
|
||
|
||
- 在 **Project** 窗口中双击 `Assets/Scenes/main.unity` 打开主菜单场景
|
||
- 点击顶部工具栏的 ▶ **Play** 按钮即可运行
|
||
|
||
---
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
VFSUnity/
|
||
├── Assets/
|
||
│ ├── Scripts/
|
||
│ │ ├── Core/ # 核心管理器
|
||
│ │ │ ├── GameManager.cs # 全局状态管理（单例）
|
||
│ │ │ ├── ExperimentController.cs # 实验流程控制器
|
||
│ │ │ └── ConfigLoader.cs # JSON 配置加载器
|
||
│ │ ├── Data/ # 数据模型
|
||
│ │ │ ├── StepData.cs # 单步定义 ScriptableObject
|
||
│ │ │ ├── ExamQuestionData.cs # 考核题目 ScriptableObject
|
||
│ │ │ └── ExperimentConfig.cs # 实验配置 ScriptableObject
|
||
│ │ ├── Interaction/ # 交互系统
|
||
│ │ │ ├── InteractionSystem.cs # 射线检测与点击处理
|
||
│ │ │ └── DraggableObject.cs # 拖拽交互组件
|
||
│ │ ├── UI/ # UI 控制器
|
||
│ │ │ ├── MainMenuUI.cs # 主菜单界面
|
||
│ │ │ ├── ModeSelectionUI.cs # 模式选择界面
|
||
│ │ │ ├── HUDController.cs # 游戏内 HUD
|
||
│ │ │ ├── PopupSystem.cs # 弹窗系统
|
||
│ │ │ └── VideoPlayerController.cs # 画中画视频
|
||
│ │ └── Animation/
|
||
│ │ └── AnimationController.cs # 角色动画控制
|
||
│ ├── Scenes/
|
||
│ │ ├── main.unity # 主菜单场景 ⭐
|
||
│ │ ├── ModeSelection.unity # 模式选择场景
|
||
│ │ └── Experiment.unity # 实验场景（核心）
|
||
│ ├── Models/
|
||
│ │ ├── Characters/ # 角色模型（伤者、施救者）
|
||
│ │ ├── Props/ # 道具模型（急救箱、绷带、夹板）
|
||
│ │ └── Environment/ # 场景模型（田径馆）
|
||
│ ├── Animations/ # 动画文件（待导入）
|
||
│ ├── Prefabs/ # 预制体
|
||
│ ├── Materials/ # 材质
|
||
│ ├── Textures/ # 贴图
|
||
│ │ └── UI/ # UI 贴图
|
||
│ ├── Audio/ # 音频文件（语音解说）
|
||
│ ├── Video/ # 视频文件（真人演示）
|
||
│ └── Resources/
|
||
│ └── Data/
|
||
│ ├── fracture_fixation_steps.json # 肢体固定步骤配置
|
||
│ └── splint_fixation_steps.json # 夹板固定步骤配置
|
||
├── Packages/ # Unity 包依赖清单
|
||
├── ProjectSettings/ # 项目全局设置
|
||
└── README.md
|
||
```
|
||
|
||
---
|
||
|
||
## 🏗 架构设计
|
||
|
||
### 核心流程
|
||
|
||
```
|
||
MainMenu (scene: main.unity)
|
||
│ 选择实验类型（骨折固定/心肺复苏/...）
|
||
▼
|
||
ModeSelection (scene: ModeSelection.unity)
|
||
│ 选择固定方式 + 运行模式
|
||
▼
|
||
Experiment (scene: Experiment.unity)
|
||
│ GameManager（全局状态）
|
||
│ ExperimentController（步骤控制）
|
||
│ InteractionSystem（点击检测）
|
||
│ HUD（顶部提示栏 + 右侧按钮 + 进度条）
|
||
│ PopupSystem（弹窗 + 考核题 + 成绩显示）
|
||
│ VideoPlayer（画中画，学习模式）
|
||
```
|
||
|
||
### 状态管理
|
||
|
||
| 类 | 职责 |
|
||
|----|------|
|
||
| **GameManager** | 全局单例。管理实验类型、固定方式、运行模式、当前步骤、分数、考核结果 |
|
||
| **ExperimentController** | 接收用户交互事件，验证步骤完成条件，推进实验流程 |
|
||
| **InteractionSystem** | 处理鼠标射线检测，区分 UI 点击和 3D 物体点击 |
|
||
| **ConfigLoader** | 从 `Resources/Data/*.json` 加载实验步骤和考核题目数据 |
|
||
|
||
### 数据模型
|
||
|
||
| 类 | 说明 |
|
||
|----|------|
|
||
| **StepData** (ScriptableObject) | 定义单个步骤：提示文案、对话文案、交互类型、目标标签 |
|
||
| **ExamQuestionData** (ScriptableObject) | 定义考核题目：题目文案、选项、正确答案、反馈文案 |
|
||
| **ExperimentConfig** (ScriptableObject) | 实验配置容器：步骤列表 + 考核题目列表 + 固位方式 + 分数设置 |
|
||
|
||
---
|
||
|
||
## 🎮 场景说明
|
||
|
||
### 1. 主菜单场景 (`main.unity`)
|
||
|
||
- 主标题："运动伤害现场急救处理虚拟仿真实验"
|
||
- 底部 5 个功能图标按钮：心肺复苏 | 骨折固定 | 扭伤包扎 | 出血包扎 | 伤员搬运
|
||
- 点击按钮 → 跳转 `ModeSelection` 场景
|
||
|
||
### 2. 模式选择场景 (`ModeSelection.unity`)
|
||
|
||
- 顶部提示：Tip：请选择实验模式
|
||
- 固定方式选项：肢体固定 | 夹板固定
|
||
- 运行模式选项：学习模式 | 考核模式
|
||
- 底部：开始实验 | 返回主菜单
|
||
|
||
### 3. 实验场景 (`Experiment.unity`)
|
||
|
||
**场景物体：**
|
||
| 物体 | 标签 | 说明 |
|
||
|------|------|------|
|
||
| Ground | - | 地板（Plane 10x10） |
|
||
| InjuredPerson | InjuredPerson | 伤者（占位 Capsule） |
|
||
| InjuryLeg | InjuryLeg | 伤腿交互区（Sphere，伤者子物体） |
|
||
| Rescuer | Rescuer | 施救者（占位 Capsule） |
|
||
| Shoe | Shoe | 鞋子（可点击交互） |
|
||
| Bandage | Bandage | 绷带（拖拽交互） |
|
||
| Splint | Splint | 夹板（拖拽交互） |
|
||
| FirstAidKit | FirstAidKit | 急救箱 |
|
||
|
||
**UI 层：**
|
||
| 组件 | 说明 |
|
||
|------|------|
|
||
| TipBar | 顶部提示栏（学习模式显示） |
|
||
| DialogueBubble | 角色对话气泡（自动4秒消失） |
|
||
| ProgressSlider | 底部进度条 |
|
||
| 右侧按钮 | 全屏、上一步、下一步、学习/考核切换、返回 |
|
||
| VideoPanel | 右下角画中画视频（学习模式特定步骤激活） |
|
||
| PopupSystem | 弹窗系统（考核题、成绩显示、注意事项） |
|
||
|
||
---
|
||
|
||
## 📝 骨折固定实验流程（学习模式）
|
||
|
||
| 步骤 | Tip 提示 | 交互方式 | 目标标签 |
|
||
|------|----------|----------|----------|
|
||
| 0. 环境评估 | 观察周围环境是否有危险，做好防护措施 | 按钮确认 | - |
|
||
| 1. 伤情检查 | 请检查伤员受伤位置 | 点击物体 | InjuryLeg |
|
||
| 2. 脱鞋袜检查 | 请将伤员鞋袜脱掉并保存好 | 点击物体 | Shoe |
|
||
| 3. 放置衬带 | 请在正确的位置穿宽度约10cm的带子 | 拖拽交互 | Bandage |
|
||
| 4. 肢体并拢 | 请在两下肢间加衬垫 | 按钮确认 | - |
|
||
| 5. 主干固定 | 固定骨折近心端、远心端、膝关节下 | 拖拽交互 | Bandage |
|
||
| 6. 踝关节固定 | 踝关节"8"字固定 | 拖拽交互 | Bandage |
|
||
| 7. 终末检查 | 包扎完毕请检查伤肢血液循环 | 按钮确认 | - |
|
||
|
||
## 📝 考核模式题目
|
||
|
||
| 考核点 | 题目 | 选项 | 正确答案 |
|
||
|--------|------|------|----------|
|
||
| 考核点一 | 按正确顺序进行环境评估与自我介绍 | 确定 | - |
|
||
| 考核点二 | 按正确顺序检查伤情 | 确定 | - |
|
||
| 考核点三 | 请选择合适的带子宽度 | 5cm / 10cm / 20cm | 10cm |
|
||
| 考核点四 | 请选择正确的放带子顺序 | 确定（交互排序） | - |
|
||
| 考核点五 | 请选择正确的系带子顺序 | 确定（交互排序） | - |
|
||
| 考核点六 | 请选择带子打结位置 | 确定（点击目标） | - |
|
||
| 考核点七 | 请选择踝关节打结位置 | 足底 / 足背 | 足背 |
|
||
|
||
---
|
||
|
||
## 🔧 交互类型枚举
|
||
|
||
| 类型 | 值 | 说明 |
|
||
|------|-----|------|
|
||
| None | 0 | 无交互 |
|
||
| ClickObject | 1 | 点击3D物体（需匹配 targetTag） |
|
||
| ClickGround | 2 | 点击地面空白处 |
|
||
| DragDrop | 3 | 拖拽物体到目标位置 |
|
||
| ButtonConfirm | 4 | 点击 UI 按钮确认 |
|
||
| MultipleChoice | 5 | 选择选项（考核模式） |
|
||
|
||
---
|
||
|
||
## 📦 待添加资源清单
|
||
|
||
### 3D 模型
|
||
- [ ] 室内田径馆场景（跑道、看台、跳高架、跳高垫）
|
||
- [ ] 伤者角色模型（男性、运动装、骨骼绑定）
|
||
- [ ] 施救者角色模型（女性、急救员装束、骨骼绑定）
|
||
- [ ] 急救箱（带红十字）
|
||
- [ ] 绷带/三角巾
|
||
- [ ] 夹板模型
|
||
- [ ] 鞋子/袜子模型
|
||
|
||
### 动画
|
||
- [ ] 伤者：跑步循环、跳高起跳、空中姿态、落地摔倒、躺地受伤
|
||
- [ ] 施救者：站立、蹲下、检查、脱鞋、包扎手部特写
|
||
- [ ] 推荐使用 Mixamo 获取基础动画或动捕制作
|
||
|
||
### 音频
|
||
- [ ] 背景音乐
|
||
- [ ] 语音解说 TTS
|
||
|
||
### 视频
|
||
- [ ] 真人演示视频（画中画，学习模式使用）
|
||
|
||
### UI 素材
|
||
- [ ] 5 个主功能图标
|
||
- [ ] 按钮样式
|
||
- [ ] 背景图
|
||
|
||
---
|
||
|
||
## 🚀 后续开发指南
|
||
|
||
### 添加新实验类型
|
||
|
||
1. 创建新的 `Resources/Data/xxx_steps.json` 配置
|
||
2. 在 `MainMenuUI.cs` 中添加按钮监听
|
||
3. 在 `ConfigLoader.cs` 中添加加载方法
|
||
|
||
### 替换占位模型
|
||
|
||
1. 导入真实模型到 `Assets/Models/` 对应子目录
|
||
2. 在 Experiment 场景中替换 Capsule/Cube 占位物
|
||
3. 确保各物体的 Tag 和 Collider 设置正确
|
||
|
||
### 添加真实动画
|
||
|
||
1. 导入动画到 `Assets/Animations/`
|
||
2. 为角色创建 Animator Controller
|
||
3. 在 `AnimationController.cs` 中关联 Animator 引用和状态名
|
||
|
||
### 部署 MCP for Unity（可选）
|
||
|
||
在 Unity 中：**Window → Package Manager → + → Add package from git URL**，粘贴：
|
||
```
|
||
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
|
||
```
|
||
然后 **Window → MCP for Unity → Configure All Detected Clients**。
|
||
|
||
---
|
||
|
||
## 依赖包
|
||
|
||
核心依赖已在 `Packages/manifest.json` 中锁定版本：
|
||
|
||
- **Universal RP** 14.0.12 — 渲染管线
|
||
- **TextMeshPro** 3.0.7 — 文字渲染
|
||
- **Timeline** 1.7.7 — 过场动画
|
||
- **UGUI** 1.0.0 — UI 系统
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
- **不要删除 `.meta` 文件** — Unity 用它们追踪资源和 GUID
|
||
- `.gitignore` 已配置忽略 Library、Temp、Logs、UserSettings 等生成目录
|
||
- 占位模型 (Capsule/Cube) 后续需替换为真实美术资源
|
||
- 考核判分逻辑在 `GameManager.RecordExamAnswer()` 中实现
|
||
- 步骤配置通过 `Resources/Data/*.json` 管理，可在 Unity 外编辑
|