Files
aibis-dream/Assets/Scripts/MiniGame/HuoShan/Language/QuickStart.md
T
2025-11-12 19:46:16 +08:00

151 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 快速开始指南
## 5分钟快速设置
### 步骤1:创建场景对象
1. 在Hierarchy中右键 → Create Empty
2. 命名为 "LanguageParticleSystem"
3. 添加组件:`LanguageParticleManager`
### 步骤2:检查依赖
确保项目已安装:
- ✅ TextMeshProUnity内置)
- ✅ DOTweenAsset Store
- ✅ ShapesAsset Store
如果缺少DOTween,在Manager中会有命名空间错误。
### 步骤3:配置参数(可选)
在Inspector中调整默认值:
```
Canvas Size: 10
Floating Count: 100
Candidate Count: 50
Red Particle Count: 8
Connection Distance: 2
Target Sentence: "别过来我感觉害怕"
Waveform Amplitude: 0.3
Interaction Radius: 0.5
```
### 步骤4:设置相机
1. 选择Main Camera
2. 设置Position: (0, 0, -10)
3. 设置Size (Orthographic): 5-6
### 步骤5:运行
点击Play,系统会自动:
- 创建10x10的World Space Canvas
- 生成100个背景浮动文字
- 生成50个候选粒子(其中8个红色)
## 游戏操作
### 第一阶段:连接粒子
- **左键点击**:排斥粒子(推开)
- **右键点击**:吸引粒子(涟漪)
- **目标**:让所有红色粒子连成一体,且远离蓝色粒子
### 第二阶段:观看揭示
- 红色粒子自动排列
- 逐个显示文字
- 文字开始剧烈抖动
### 第三阶段:抚平波形
- **按住左键并拖动**:抚平异常波形
- **目标**:让所有波形变平,文字停止抖动并消散
## 常见问题快速解决
### 文字显示为方块?
**原因**:字体不支持中文
**解决**
1. Window → TextMeshPro → Font Asset Creator
2. 选择支持中文的字体(如:思源黑体、微软雅黑)
3. Character Set: Custom Characters
4. 粘贴`TextParticle.cs`中的`chineseChars`字符串
5. Generate Font Atlas
### 看不到粒子?
**原因**:相机位置或Canvas设置问题
**解决**
- 相机Z坐标应为负值(如-10
- Canvas Render Mode应为World Space
- 检查粒子的Z坐标是否为0
### Shapes相关错误?
**原因**:未安装Shapes插件
**解决**
1. 从Asset Store安装Shapes
2. 或者临时注释掉渲染器相关代码:
- ConnectionRenderer.cs
- WaveformRenderer.cs
- LanguageParticleManager.cs中的渲染器初始化
### DOTween错误?
**原因**:未安装DOTween
**解决**
1. 从Asset Store安装DOTween (免费)
2. 或者移除相关using和功能(本系统中DOTween可选)
## 性能调优
### 低配置设备
```
Floating Count: 50
Candidate Count: 30
Red Particle Count: 6
```
### 中配置设备(推荐)
```
Floating Count: 100
Candidate Count: 50
Red Particle Count: 8
```
### 高配置设备
```
Floating Count: 200
Candidate Count: 80
Red Particle Count: 10
```
## 视觉调优
### 增强视觉效果
- 增加`Waveform Amplitude`0.5-0.8
- 增加`Interaction Radius`0.8-1.0
- 调整渲染器颜色(在Renderer组件中)
### 减少视觉混乱
- 减少`Floating Count`
- 减少`Connection Distance`
- 降低背景文字透明度(修改FloatingTextParticle.cs
## 下一步
- 阅读`README.md`了解完整功能
- 查看`LanguageParticleSystem_Summary.md`了解技术细节
- 自定义字符集和目标句子
- 添加音效和粒子特效
## 技术支持
遇到问题?检查:
1. Console是否有错误
2. 所有依赖是否已安装
3. 相机设置是否正确
4. 粒子是否在相机视野内
调试技巧:
- 在Scene视图中观察粒子位置
- 使用Gizmos显示连接关系
- 在Inspector中监控粒子状态