6. 教程

逐步学习 Sync 引擎的各个组件。每个教程都配有可独立运行的完整 GDScript 代码。

目录

• 6.1. 构建谱面
  • 6.1.1. 1. 创建文档谱面
  • 6.1.2. 2. 设置元数据
  • 6.1.3. 3. BPM 轴与拍号
  • 6.1.4. 4. 创建轨道并添加音符
  • 6.1.5. 5. 动画轴
  • 6.1.6. 6. 保存与加载
  • 6.1.7. 7. 验证
  • 6.1.8. 完整代码
  • 6.1.9. SyncBeat 构造说明
  • 6.1.10. 音符种类参考
• 6.2. 编辑器组件教程
  • 6.2.1. 步骤 1：SyncProgressManager — 进度管理
  • 6.2.2. 步骤 2：SyncTimeline — 归一化坐标映射
  • 6.2.3. 步骤 3：输入映射 — 点击位置 → 节拍
  • 6.2.4. 步骤 4：SyncBeatGrid — 节拍线数据
  • 6.2.5. 步骤 5：自定义颜色
  • 6.2.6. 步骤 6：BeatlineView — 完整的绘制 + 输入控件
  • 6.2.7. 完整代码
  • 6.2.8. 关键设计理念
• 6.3. 游戏运行教程
  • 6.3.1. 步骤 1：构建谱面
  • 6.3.2. 步骤 2：创建播放器并编译
  • 6.3.3. 步骤 3：判初——枚举所有音符并缓存静态数据
  • 6.3.4. 步骤 4：每帧推进 + 自写判定
  • 6.3.5. 步骤 5：自定义种类的判定分发
  • 6.3.6. 步骤 6：输出总结
  • 6.3.7. 完整代码
  • 6.3.8. 判定层与渲染层的边界
  • 6.3.9. 下一步