Files
aibis-dream/Assets/Scripts/MiniGame/HuoShan/Language/QuickStart.md
T
2026-07-28 21:34:42 +08:00

3.5 KiB
Raw Blame History

快速开始指南

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: 由启动命令传入,不在 Inspector 中保存测试文案
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. 粘贴 Params/hs.exp.pool 及正式 Express 文案所需字符
  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 Amplitude0.5-0.8
  • 增加Interaction Radius0.8-1.0
  • 调整渲染器颜色(在Renderer组件中)

减少视觉混乱

  • 减少Floating Count
  • 减少Connection Distance
  • 降低背景文字透明度(修改FloatingTextParticle.cs

下一步

  • 阅读README.md了解完整功能
  • 查看LanguageParticleSystem_Summary.md了解技术细节
  • 自定义字符集和目标句子
  • 添加音效和粒子特效

技术支持

遇到问题?检查:

  1. Console是否有错误
  2. 所有依赖是否已安装
  3. 相机设置是否正确
  4. 粒子是否在相机视野内

调试技巧:

  • 在Scene视图中观察粒子位置
  • 使用Gizmos显示连接关系
  • 在Inspector中监控粒子状态