# Unity 迁移快速开始清单

## 📅 每日任务清单

### 第1天：环境搭建
- [ ] 下载并安装Unity Hub
- [ ] 安装Unity 2022.3 LTS
- [ ] 安装Visual Studio Community
- [ ] 创建Unity账号
- [ ] 激活个人版许可证
- [ ] 创建测试项目"TaikoUnityTest"
- [ ] 熟悉Unity界面5分钟

### 第2-3天：基础学习
- [ ] 观看"Unity入门"教程（1-2小时）
- [ ] 创建第一个GameObject
- [ ] 创建第一个C#脚本
- [ ] 运行第一个程序
- [ ] 学习Transform组件（Position, Rotation, Scale）
- [ ] 学习Sprite Renderer

### 第4-5天：C#编程
- [ ] 学习C#变量类型
- [ ] 学习C#类和函数
- [ ] 学习MonoBehaviour生命周期（Start, Update）
- [ ] 创建一个简单的移动脚本
- [ ] 学习Input系统
- [ ] 学习Debug.Log调试

### 第6-7天：简单Demo
- [ ] 创建音符Sprite
- [ ] 创建音符移动脚本
- [ ] 创建判定线
- [ ] 实现按键检测
- [ ] 实现简单的分数系统
- [ ] 添加背景音乐

---

## 🛠️ 开发阶段清单

### 第1周：项目搭建
- [ ] 创建正式项目"TaikoUnity"
- [ ] 创建文件夹结构
- [ ] 创建基础脚本框架
  - [ ] GameManager.cs
  - [ ] NoteManager.cs
  - [ ] ScoreManager.cs
  - [ ] InputManager.cs
  - [ ] UIManager.cs
- [ ] 创建数据类（GameData.cs）
- [ ] 测试脚本是否能正常编译

### 第2周：核心功能
- [ ] 实现Note基类
- [ ] 实现DonNote和KaNote
- [ ] 实现InputManager输入检测
- [ ] 实现判定系统
- [ ] 实现分数计算
- [ ] 测试单个音符的打击

### 第3周：谱面系统
- [ ] 创建TJAParser解析器
- [ ] 测试解析单个.tja文件
- [ ] 实现ChartLoader
- [ ] 实现音符自动生成
- [ ] 测试完整歌曲流程

### 第4周：音频和UI
- [ ] 实现AudioManager
- [ ] 导入音频资源
- [ ] 实现音乐同步
- [ ] 创建UI界面
- [ ] 实现分数显示
- [ ] 实现连击显示

### 第5-6周：场景和流程
- [ ] 创建主菜单场景
- [ ] 创建选歌场景
- [ ] 创建游戏场景
- [ ] 实现场景切换
- [ ] 实现游戏开始倒计时
- [ ] 实现游戏结束和结果界面

### 第7-8周：优化和完善
- [ ] 添加打击特效
- [ ] 添加动画
- [ ] 实现对象池优化
- [ ] 添加设置界面
- [ ] 添加音频延迟调整
- [ ] 添加判定时间窗口调整
- [ ] 全面测试

---

## 📋 功能实现优先级

### P0 - 必须实现（核心玩法）
1. ✅ 音符从右向左移动
2. ✅ 按键判定（Don/Ka）
3. ✅ 分数计算
4. ✅ 连击系统
5. ✅ 音乐播放和同步
6. ✅ 谱面加载

### P1 - 重要功能
1. ⭐ 主菜单
2. ⭐ 选歌界面
3. ⭐ 结果界面
4. ⭐ 大音符支持
5. ⭐ 连打支持
6. ⭐ 气球音符支持

### P2 - 增强体验
1. 💡 打击特效
2. 💡 音效
3. 💡 背景动画
4. 💡 难度选择
5. 💡 暂停功能
6. 💡 设置界面

### P3 - 高级功能
1. 🚀 多人模式
2. 🚀 自定义皮肤
3. 🚀 成就系统
4. 🚀 排行榜
5. 🚀 回放系统

---

## 🎯 每周检查点

### 第1周检查
- ✅ Unity环境已搭建
- ✅ 能创建GameObject和脚本
- ✅ 理解Start()和Update()的作用
- ✅ 能让物体移动

### 第2周检查
- ✅ 项目结构已创建
- ✅ 核心脚本框架完成
- ✅ 能编译运行无错误

### 第4周检查
- ✅ 能打击单个音符
- ✅ 判定系统工作正常
- ✅ 分数能正确计算

### 第6周检查
- ✅ 能加载.tja谱面
- ✅ 音符能按谱面生成
- ✅ 音乐能正常播放
- ✅ 音乐和音符同步

### 第8周检查
- ✅ 完整游戏流程跑通
- ✅ UI界面完整
- ✅ 能选歌并游玩
- ✅ 能看到结果

### 第12周检查（最终）
- ✅ 所有核心功能完成
- ✅ 优化完成，运行流畅
- ✅ 测试通过
- ✅ 能打包发布

---

## 🔧 调试清单

遇到问题时按此清单检查：

### 脚本相关
- [ ] 脚本是否附加到GameObject上？
- [ ] 脚本名称和类名是否一致？
- [ ] public变量是否在Inspector赋值？
- [ ] 是否有编译错误（查看Console）？
- [ ] 是否调用了Destroy但还在使用对象？

### 音符不显示
- [ ] Sprite是否正确赋值？
- [ ] Sprite Renderer是否启用？
- [ ] Position是否在镜头范围内？
- [ ] Sorting Layer是否正确？
- [ ] GameObject是否激活（Active）？

### 音符不移动
- [ ] Note脚本是否附加？
- [ ] Update()函数是否正确？
- [ ] speed值是否为0？
- [ ] Time.timeScale是否为0（暂停状态）？

### 输入无响应
- [ ] InputManager是否添加到场景中？
- [ ] 按键设置是否正确？
- [ ] 是否有音符在判定范围内？
- [ ] 音符Tag是否设置为"Note"？

### 音乐不播放
- [ ] AudioSource组件是否存在？
- [ ] AudioClip是否赋值？
- [ ] 音量是否为0？
- [ ] 是否调用了Play()？
- [ ] 音频文件是否正确导入？

### 谱面解析失败
- [ ] 文件路径是否正确？
- [ ] 文件是否在StreamingAssets文件夹？
- [ ] .tja文件格式是否正确？
- [ ] 是否有中文编码问题？

---

## 📖 学习资源速查

### Unity官方
- Unity Learn: https://learn.unity.com/
- 脚本API: https://docs.unity3d.com/ScriptReference/
- 手册: https://docs.unity3d.com/Manual/

### C#学习
- Microsoft Learn: https://learn.microsoft.com/zh-cn/dotnet/csharp/
- C# 基础教程: https://www.runoob.com/csharp/csharp-tutorial.html

### 视频教程
- Brackeys (YouTube): 基础到进阶
- M_Studio (Bilibili): Unity中文教程
- Sykoo (YouTube): 节奏游戏专题

### 社区求助
- Unity官方论坛: https://forum.unity.com/
- Stack Overflow: https://stackoverflow.com/questions/tagged/unity3d
- Unite China论坛: https://connect.unity.com/
- Discord: Unity Game Dev Community

---

## 💾 代码片段速查

### 创建GameObject
```csharp
GameObject obj = new GameObject("MyObject");
GameObject obj = Instantiate(prefab);
GameObject obj = Instantiate(prefab, position, Quaternion.identity);
```

### 查找GameObject
```csharp
GameObject obj = GameObject.Find("ObjectName");
GameObject obj = GameObject.FindGameObjectWithTag("Player");
GameObject[] objs = GameObject.FindGameObjectsWithTag("Note");
```

### 组件操作
```csharp
// 获取组件
SpriteRenderer sr = GetComponent<SpriteRenderer>();
SpriteRenderer sr = gameObject.GetComponent<SpriteRenderer>();

// 添加组件
AudioSource audio = gameObject.AddComponent<AudioSource>();

// 启用/禁用组件
sr.enabled = false;
```

### 移动对象
```csharp
// 直接设置位置
transform.position = new Vector3(x, y, z);

// 相对移动
transform.position += Vector3.left * speed * Time.deltaTime;
transform.Translate(Vector3.left * speed * Time.deltaTime);
```

### 输入检测
```csharp
// 按键按下（一次）
if(Input.GetKeyDown(KeyCode.Space)) { }

// 按键持续按住
if(Input.GetKey(KeyCode.Space)) { }

// 按键松开
if(Input.GetKeyUp(KeyCode.Space)) { }

// 轴输入（-1到1）
float h = Input.GetAxis("Horizontal");
```

### 音频播放
```csharp
// 播放
audioSource.Play();
audioSource.PlayOneShot(clip);

// 停止
audioSource.Stop();
audioSource.Pause();
```

### 协程（延迟执行）
```csharp
StartCoroutine(DelayFunction());

IEnumerator DelayFunction()
{
    yield return new WaitForSeconds(2f);
    // 2秒后执行
}
```

### 场景加载
```csharp
using UnityEngine.SceneManagement;

SceneManager.LoadScene("SceneName");
SceneManager.LoadScene(0); // 按索引加载
```

---

## ⚡ 快捷键速查

### Unity编辑器
- `Ctrl + S`: 保存场景
- `Ctrl + Shift + S`: 另存场景
- `Ctrl + P`: 播放/停止
- `Ctrl + Shift + P`: 暂停
- `F`: 聚焦到选中对象
- `Ctrl + D`: 复制对象
- `Ctrl + Z`: 撤销
- `Ctrl + Y`: 重做

### Visual Studio
- `F5`: 启动调试
- `F9`: 设置断点
- `F10`: 单步跳过
- `F11`: 单步进入
- `Ctrl + K, Ctrl + C`: 注释
- `Ctrl + K, Ctrl + U`: 取消注释
- `Ctrl + .`: 快速操作

---

## 📞 获取帮助

如果遇到问题：

1. **查看Console窗口**：错误信息通常很有帮助
2. **Google搜索错误信息**：加上"Unity"关键词
3. **查看Unity文档**：官方API文档非常详细
4. **提问时提供**：
   - 错误信息截图
   - 相关代码
   - Unity版本
   - 想达到的效果

---

**记住**：每个程序员都是从零开始的，遇到问题是正常的，坚持学习就能成功！💪