企业官网建设流程全解析

1. 项目概述：当游戏“听见”音乐

如果你做过Unity游戏开发，尤其是尝试过让游戏画面、角色动作或者特效与背景音乐的节奏、旋律同步，你大概率经历过一段痛苦的时光。手动写代码去解析音频波形、计算节拍时间、处理不同设备上的音频延迟……这些工作不仅繁琐，而且极易出错，最终效果往往差强人意。这正是我当初决定深入研究Koreographer这个Unity音频插件的初衷。这个“基于Koreographer与Unity3D的声音交互设计实战项目”，本质上就是探索如何将音乐从单纯的“背景氛围”转变为驱动游戏逻辑、塑造玩家体验的“核心交互层”。

简单来说，Koreographer是一个“主动式”的音频中间件。它不像传统音频系统那样被动播放声音，而是允许你在音频编辑阶段就“埋入”各种事件标记（我们称之为Koreography事件），比如节拍点、旋律变化点、歌词时间点等。在游戏运行时，Koreographer会精准地触发这些事件，你的游戏逻辑只需要监听并响应这些事件即可。这就像给音乐配上了一份精确到毫秒的“事件说明书”，游戏引擎只需按图索骥，就能实现完美的音画同步。

这个项目适合所有希望提升游戏沉浸感和表现力的Unity开发者，无论你是想制作《节奏光剑》那样的硬核音游，还是想在RPG中让BOSS战的技能释放与音乐高潮同步，亦或是想在解谜游戏中用旋律的起伏来暗示谜题线索，Koreographer都能提供一套成熟、可靠的解决方案。接下来，我将从一个完整实战项目的角度，拆解从环境搭建、核心概念理解、事件设计到高级应用与性能优化的全流程，并分享大量官方文档里不会写的“踩坑”心得。

2. 核心思路与工具选型：为什么是Koreographer？

在启动任何项目前，理清“为什么选择这个工具”至关重要。市面上并非没有其他音频交互方案，比如Unity自带的AudioSource结合代码分析、第三方DSP库如FMOD或Wwise的事件系统，甚至自己写FFT（快速傅里叶变换）分析。但经过对比和实际项目验证，Koreographer在特定场景下具有不可替代的优势。

2.1 核心优势解析：从“实时分析”到“预定义事件”

传统实现音乐交互的思路大多是“实时分析”：在Update()中获取当前音频播放时间，或者分析音频频谱数据，然后判断是否到达了某个节拍或阈值。这种方法存在几个固有难题：

1. 性能开销：实时音频分析（尤其是FFT）是CPU密集型操作，在移动端或低配PC上可能成为性能瓶颈。
2. 精度与延迟：受系统音频缓冲区、设备驱动差异和游戏帧率波动影响，实时计算的时间点很难做到毫秒级精准，且不同平台延迟不一致，调试噩梦。
3. 开发复杂度：识别复杂的音乐结构（如副歌、桥段）或非节拍性事件（如某句歌词）需要深厚的信号处理知识，对游戏开发者门槛过高。

Koreographer采用了截然不同的“预定义事件”范式。其工作流分为离线的“创作阶段”和运行时的“触发阶段”：

• 创作阶段：在专用的Koreography Editor（或支持它的DAW如Reaper）中，直接在你的音乐波形上点击，打上各种事件标记。这个过程是“所见即所得”的，完全精准，不依赖任何实时计算。
• 触发阶段：游戏运行时，Koreographer插件读取音乐文件及其对应的“事件元数据”文件（.koreography文件）。它内部维护一个高精度的音频时钟，在事件该触发的时候，向Unity发送事件通知。

这种模式带来了根本性的好处：

• 零运行时分析开销：CPU只负责按时间表触发事件，负担极轻。
• 绝对精准与一致性：事件时间点在编辑时就已确定，在任何设备、任何帧率下触发时间都完全一致，彻底解决了跨平台同步问题。
• 创作友好：策划、音频设计师甚至不需要懂代码，就能在音频软件中设计复杂的音乐交互逻辑。

2.2 与其他方案的横向对比

为了更清晰地定位Koreographer，我们可以做一个快速对比：

注意：这个对比并非说Koreographer全面胜出。对于需要复杂动态混音、环境音效管理、多平台音频优化的3A级项目，FMOD/Wwise仍是更专业的选择。Koreographer的杀手锏在于其极简、精准的音乐事件驱动能力，特别适合“音乐即玩法”的项目。

2.3 项目基础环境搭建

开始实战前，需要准备好环境。从Asset Store购买并导入Koreographer插件后，你的Project面板会出现相关文件夹。我强烈建议在导入后，首先打开Koreographer/Examples场景，快速浏览一遍官方提供的几个示例，对核心组件有个感性认识。

核心组件只有三个，必须理解：

1. Koreographer：全局管理器单例。通常一个场景一个，负责协调所有音频播放和事件调度。
2. Koreographer Component：需要挂载到播放音频的GameObject上（通常是摄像机或一个空物体）。它关联了具体的音频剪辑（AudioClip）和对应的Koreography数据资产。
3. Koreography：这是一种ScriptableObject资产，它存储了音乐文件（或引用）以及所有你在编辑器中创建的事件轨道（Track）和事件（Event）。

一个常见的误区是试图用多个Koreographer Component控制同一段音乐的不同部分。实际上，一段音乐对应一个Koreographer Component和一个Koreography资产。如果你需要多段音乐切换或混合，需要通过逻辑来控制这些组件的启用、禁用或音频剪辑的切换。

3. 核心工作流详解：从音乐到游戏事件

理解了“为什么”之后，我们进入“怎么做”的核心环节。Koreographer的工作流可以清晰地分为“事件创作”和“事件响应”两大步。

3.1 事件创作：在音乐中埋下“触发器”

事件创作是整个流程的基石，也是最体现Koreographer价值的地方。你不需要写代码，而是在视觉化界面中完成。

第一步：创建Koreography资产在Project面板右键 -> Create -> Koreographer -> Koreography。这会创建一个.asset文件。选中它，在Inspector面板中，将你的背景音乐（AudioClip）拖拽到Audio Clip字段。

第二步：使用Koreography Editor添加事件选中Koreography资产，点击Inspector下方的Open Koreography Editor按钮，会打开一个独立的编辑器窗口。窗口上半部分是音频波形图，下半部分是事件轨道列表。

1. 添加轨道（Track）：点击Add Track，选择事件类型。最常用的是Beat（节拍）和Custom（自定义）。Beat轨道Koreographer可以帮你自动生成节拍，但为了最大控制权，我通常更推荐使用Custom轨道，手动标记所有关键点。
2. 标记事件（Event）：在波形图上，找到你想要触发游戏逻辑的时间点（比如鼓点响起的那一刻、人声进入的瞬间、旋律变化的节点），按住Ctrl/Cmd键并点击鼠标左键，就会在该时间点创建一个事件。你可以在右侧面板调整这个事件的精确位置（Sample单位，非常精确）和数值（Payload）。
3. 理解Payload：这是事件的“数据载体”。对于Beat事件，Payload可能就是第几拍。对于Custom事件，Payload可以是一个整数（Int）、一个浮点数（Float）、一个字符串（Text）甚至一个颜色（Color）。例如，你可以用IntPayload表示事件类型（1=生成敌人，2=改变背景颜色），用TextPayload传递歌词，用FloatPayload表示音量变化幅度。

实操心得：事件命名的艺术一个复杂的曲子可能有上百个事件。千万不要用默认的“Custom Event 1, 2, 3...”。在创建Custom轨道时，就给它起一个描述性的名字，如“Enemy_Spawn”、“Background_Color_Shift”、“Lyrics_Line”。在事件Payload的编辑框中，也可以添加注释。这会在后期调试和团队协作中节省大量时间。

3.2 事件响应：在Unity中“聆听”并行动

事件标记好了，接下来就是在游戏运行时捕获并处理它们。Koreographer提供了两种主要的事件监听方式，适应不同场景。

方式一：使用 Koreography Event Handler 组件（快速原型）这是最简单的方法，适合快速测试和简单的交互。

1. 在需要响应事件的GameObject上（比如一个方块、一个粒子发射器），添加Koreography Event Handler组件。
2. 在组件中，指定要监听的Koreography资产和具体的Track名称。
3. 然后，将你的处理函数（例如一个public void OnEvent(KoreographyEvent koreoEvent)）拖拽到组件的Unity Event回调中。

这种方式利用了Unity的UnityEvent系统，无需编写监听代码，通过Inspector面板即可完成连接。优点是快，缺点是不够灵活，难以处理复杂的、需要状态管理的逻辑，并且大量使用可能会影响性能。

方式二：通过代码脚本监听（推荐用于生产）对于核心玩法，我强烈推荐使用代码监听的方式，它更强大、更高效。

using SonicBloom.Koreo; using UnityEngine; public class MusicDrivenController : MonoBehaviour { // 关联的Koreography资产，在Inspector中拖拽赋值 [SerializeField] private Koreography _koreography; // 要监听的事件轨道名称 [SerializeField] private string _eventTrackName; void Start() { // 检查Koreographer单例是否存在 if (Koreographer.Instance != null) { // 注册事件监听函数 Koreographer.Instance.RegisterForEvents(_eventTrackName, OnMusicEvent); } } void OnDestroy() { // 非常重要！在对象销毁时取消注册，避免内存泄漏和空引用错误 if (Koreographer.Instance != null) { Koreographer.Instance.UnregisterForEvents(_eventTrackName, OnMusicEvent); } } // 事件处理函数 void OnMusicEvent(KoreographyEvent koreoEvent) { // 1. 获取事件Payload（以Int为例） int eventValue = koreoEvent.GetIntValue(); // 2. 根据Payload值执行不同的游戏逻辑 switch (eventValue) { case 1: SpawnEnemyAtBeat(); break; case 2: ChangeBackgroundColor(); break; case 3: StartParticleEffect(); break; default: Debug.Log($"收到未知事件，Payload: {eventValue}"); break; } // 你也可以获取事件的时间信息（单位：秒） float eventTimeInSeconds = koreoEvent.StartSample / (float)_koreography.SampleRate; // Debug.Log($"事件在 {eventTimeInSeconds:F2} 秒触发"); } void SpawnEnemyAtBeat() { /* 生成敌人逻辑 */ } void ChangeBackgroundColor() { /* 改变颜色逻辑 */ } void StartParticleEffect() { /* 粒子效果逻辑 */ } }

这段代码展示了标准模式：在Start中注册监听，在OnDestroy中取消，在事件处理函数OnMusicEvent中解析Payload并执行业务逻辑。这种方式将控制权完全交给了代码，你可以在这里进行复杂的计算、状态判断、调用其他系统等。

3.3 高级事件类型与Payload的创造性使用

除了基本的触发，Koreographer的事件系统还能支持更复杂的交互模式。

• 连续事件（Continuous Events）：一个事件可以拥有“持续时间”（Start Sample 和 End Sample）。这对于处理长音、一段歌词高亮、或者需要持续一段时间的游戏状态（如“狂暴状态持续8个小节”）非常有用。在事件处理函数中，你可以通过koreoEvent.IsOneOff()判断是瞬时事件还是连续事件，并通过koreoEvent.StartSample和koreoEvent.EndSample获取时间范围。
• Payload的复合使用：不要局限于一种Payload。你可以创建多个Custom轨道，分别承载不同类型的数据。例如，一个“Gameplay”轨道用Int Payload触发玩法，一个“VFX”轨道用Float Payload控制粒子强度，一个“UI”轨道用Text Payload更新歌词显示。这样逻辑清晰，易于维护。
• 动态响应：事件处理函数里不仅可以执行动作，还可以基于当前游戏状态做决策。例如，收到“生成敌人”事件时，先检查当前屏幕上敌人数量是否超过上限，或者玩家是否处于无敌状态，再决定是否真正生成。

4. 实战项目构建：一个音乐可视化解谜小游戏

理论说得再多，不如动手做一个。我们构想一个简单的解谜游戏原型：“旋律之门”。玩家身处一个房间，房间中央有一扇门，门上有一个图案。四周有四个不同颜色的水晶柱。背景播放一首有清晰段落（主歌A、副歌B、间奏C、尾奏D）的音乐。玩家需要根据音乐的段落，按正确顺序激活水晶柱，才能打开门。

4.1 项目设计与Koreography配置

1. 音乐分析：选择一首结构清晰的音乐（例如Intro 4小节 -> A段 8小节 -> B段 8小节 -> C段 4小节 -> D段 4小节）。在DAW或听觉上标记出每个段落的起始时间点。
2. 创建Koreography资产：导入音乐，创建资产。
3. 设计事件轨道：
   • Track_Section_Change(Custom, Text Payload): 在音乐每个段落的起始点标记事件，Payload分别为 “Intro”, “Section_A”, “Section_B”, “Section_C”, “Section_D”。
   • Track_Beat(Beat): 使用Koreographer的节拍检测功能（需在Koreography资产中设置BPM）自动生成节拍事件，用于驱动水晶柱的脉冲光效。
   • Track_Puzzle_Hint(Custom, Int Payload): 在特定段落内，标记几个关键点，Payload为1-4，对应提示应该激活的水晶柱颜色顺序。

4.2 核心逻辑实现

我们创建两个核心脚本：MusicSectionManager和CrystalPillar。

MusicSectionManager.cs (单例，管理音乐段落和谜题逻辑)

using SonicBloom.Koreo; using UnityEngine; using System.Collections.Generic; public class MusicSectionManager : MonoBehaviour { public static MusicSectionManager Instance; [Header("Koreography Setup")] [SerializeField] private Koreography _mainKoreography; [SerializeField] private string _sectionTrackName = "Track_Section_Change"; [SerializeField] private string _hintTrackName = "Track_Puzzle_Hint"; [Header("Puzzle Settings")] [SerializeField] private List<int> _correctSequence = new List<int> { 1, 3, 4, 2 }; // 正确的水晶柱激活顺序 private List<int> _playerInputSequence = new List<int>(); private string _currentSection = ""; [Header("Crystal References")] [SerializeField] private CrystalPillar[] _crystalPillars; // 拖拽赋值四个水晶柱 void Awake() { if (Instance == null) Instance = this; else Destroy(gameObject); } void Start() { if (Koreographer.Instance != null) { Koreographer.Instance.RegisterForEvents(_sectionTrackName, OnSectionChange); Koreographer.Instance.RegisterForEvents(_hintTrackName, OnPuzzleHint); } // 初始化水晶柱引用 foreach (var crystal in _crystalPillars) { crystal.Initialize(this); } } void OnSectionChange(KoreographyEvent koreoEvent) { _currentSection = koreoEvent.GetTextValue(); Debug.Log($"进入段落: {_currentSection}"); // 当音乐进入特定段落时，重置玩家输入（例如每次副歌开始时） if (_currentSection == "Section_B") { ResetPuzzle(); } } void OnPuzzleHint(KoreographyEvent koreoEvent) { int hintIndex = koreoEvent.GetIntValue(); // 这里可以触发一个UI提示，比如在屏幕上闪烁对应水晶柱的图标 Debug.Log($"提示: 激活水晶柱 {hintIndex}"); // 简单起见，我们让对应水晶柱高亮一下作为提示 if (hintIndex >= 1 && hintIndex <= _crystalPillars.Length) { _crystalPillars[hintIndex - 1].PlayHintEffect(); } } // 这个方法由CrystalPillar调用 public void OnCrystalActivated(int crystalId) { _playerInputSequence.Add(crystalId); Debug.Log($"玩家激活了水晶柱 {crystalId}，当前序列: {string.Join(",", _playerInputSequence)}"); // 检查序列是否正确 CheckSequence(); } void CheckSequence() { if (_playerInputSequence.Count != _correctSequence.Count) return; for (int i = 0; i < _correctSequence.Count; i++) { if (_playerInputSequence[i] != _correctSequence[i]) { // 顺序错误，惩罚玩家（比如屏幕震动，扣血）并重置 Debug.Log("顺序错误！"); ResetPuzzle(); return; } } // 完全正确！ Debug.Log("谜题解开！门打开了！"); // 触发开门动画、音效等 ResetPuzzle(); // 为下一次准备 } void ResetPuzzle() { _playerInputSequence.Clear(); foreach (var crystal in _crystalPillars) { crystal.Deactivate(); } Debug.Log("谜题已重置"); } void OnDestroy() { if (Koreographer.Instance != null) { Koreographer.Instance.UnregisterForEvents(_sectionTrackName, OnSectionChange); Koreographer.Instance.UnregisterForEvents(_hintTrackName, OnPuzzleHint); } } }

CrystalPillar.cs (挂载在每个水晶柱上)

using UnityEngine; public class CrystalPillar : MonoBehaviour { [SerializeField] private int _crystalId = 1; // 在Inspector中设置，1-4 [SerializeField] private Material _activeMaterial; [SerializeField] private Material _inactiveMaterial; [SerializeField] private ParticleSystem _hintParticles; private MeshRenderer _meshRenderer; private bool _isActive = false; private MusicSectionManager _manager; public void Initialize(MusicSectionManager manager) { _manager = manager; _meshRenderer = GetComponent<MeshRenderer>(); Deactivate(); // 初始状态为非激活 } void OnMouseDown() // 简单用点击交互，实际项目可能用其他方式 { if (!_isActive) { Activate(); _manager?.OnCrystalActivated(_crystalId); } } public void Activate() { _isActive = true; _meshRenderer.material = _activeMaterial; // 可以播放激活音效 } public void Deactivate() { _isActive = false; _meshRenderer.material = _inactiveMaterial; } public void PlayHintEffect() { if (_hintParticles != null) { _hintParticles.Play(); } // 也可以让材质闪烁等 } }

4.3 节拍驱动视觉效果

为了让游戏更具节奏感，我们可以让水晶柱随着节拍“呼吸”。创建另一个脚本BeatPulseEffect.cs，监听节拍轨道。

using SonicBloom.Koreo; using UnityEngine; public class BeatPulseEffect : MonoBehaviour { [SerializeField] private Koreography _koreography; [SerializeField] private string _beatTrackName = "Track_Beat"; [SerializeField] private CrystalPillar[] _crystalsToPulse; [Header("Pulse Settings")] [SerializeField] private float _pulseScale = 1.2f; [SerializeField] private float _pulseDuration = 0.2f; private Vector3[] _originalScales; private float[] _pulseTimers; void Start() { if (Koreographer.Instance != null) { Koreographer.Instance.RegisterForEvents(_beatTrackName, OnBeat); } _originalScales = new Vector3[_crystalsToPulse.Length]; _pulseTimers = new float[_crystalsToPulse.Length]; for (int i = 0; i < _crystalsToPulse.Length; i++) { if (_crystalsToPulse[i] != null) { _originalScales[i] = _crystalsToPulse[i].transform.localScale; } } } void OnBeat(KoreographyEvent koreoEvent) { // 简单起见，让所有水晶柱一起脉冲。更复杂的可以按节拍序号交替。 for (int i = 0; i < _crystalsToPulse.Length; i++) { if (_crystalsToPulse[i] != null) { _pulseTimers[i] = _pulseDuration; } } } void Update() { for (int i = 0; i < _crystalsToPulse.Length; i++) { if (_pulseTimers[i] > 0) { _pulseTimers[i] -= Time.deltaTime; float t = _pulseTimers[i] / _pulseDuration; // 使用一个缓动函数让脉冲更自然，例如OutQuad float scaleFactor = Mathf.Lerp(1f, _pulseScale, t * t); // 简单的二次缓出 _crystalsToPulse[i].transform.localScale = _originalScales[i] * scaleFactor; } } } void OnDestroy() { if (Koreographer.Instance != null) { Koreographer.Instance.UnregisterForEvents(_beatTrackName, OnBeat); } } }

通过这个实战案例，你将Koreographer的三大核心功能——段落切换（Custom Text事件）、玩法触发（Custom Int事件）、节拍同步（Beat事件）——融合到了一个具体的游戏原型中。音乐不再只是背景，它成为了驱动谜题流程、提供视觉反馈和营造氛围的核心引擎。

5. 性能优化与高级技巧

当项目规模变大，音乐事件变多，或者需要在移动端运行时，就需要考虑优化和更高级的用法。

5.1 性能优化要点

1. 事件监听器的数量与效率：避免在成千上万个GameObject上挂载Koreography Event Handler组件。尽量使用中心化的脚本（如我们上面的MusicSectionManager）进行监听，然后分发消息。这减少了Unity事件系统的开销。
2. 避免在事件回调中进行重型操作：OnMusicEvent函数会在事件触发的那一帧被立即调用。如果在这里执行实例化大量物体、加载资源等耗时操作，可能会造成卡顿。好的做法是，在事件回调中只设置一个标志位或将一个请求加入队列，在Update或协程中处理实际的重型逻辑。
3. Payload数据的优化：对于需要频繁访问的Payload数据（比如当前音乐的BPM值），可以在事件触发时将其缓存到类的成员变量中，而不是每次需要时都去Koreography事件里查找。
4. Koreography资产的加载：如果游戏有多首关卡音乐，不要在场景初始化时加载所有Koreography资产。使用Resources.Load或Addressables系统进行动态加载和卸载。

5.2 处理音频延迟与同步

这是音游或高精度同步项目的核心挑战。虽然Koreographer的预定义事件模式从根本上解决了事件触发时间的确定性问题，但音频的“播放”本身仍然存在设备延迟。

• Koreographer的延迟补偿：Koreographer组件有一个Audio Latency Compensation选项。启用后，它会尝试估计系统音频延迟并进行补偿。对于大多数项目，启用这个选项并保持默认值就能获得不错的效果。
• 手动校准：对于要求极端精度的项目（如舞蹈游戏），你需要一个“校准”阶段。通常的做法是：播放一个视觉信号（如屏幕闪烁）和一个同时触发的音频（如“嘀”声），让玩家根据听到的声音和看到的画面之间的差异来手动调整一个全局的延迟偏移量（Audio Latency Offset）。Koreographer的API允许你动态调整这个值。
• 视觉提前量：在节奏游戏中，note通常不是在与音乐完全同步的位置被击中，而是会提前出现，给玩家反应时间。这个“提前量”（lead time）是另一个需要仔细调整的参数。你可以在生成note时，用事件时间减去这个提前量作为其出现的时间。

5.3 与Unity其他系统的集成

Koreographer可以很好地与Unity的动画系统、Timeline、粒子系统等协同工作。

• 驱动动画状态机：在事件回调中，可以调用Animator.SetTrigger或Animator.SetInteger来切换动画状态，实现角色动作与音乐的精准同步（如舞蹈游戏）。
• 控制Timeline：你可以编写一个脚本，在特定音乐事件触发时，PlayableDirector.Play()或跳转到特定时间，实现过场动画与音乐的严丝合缝。
• 动态粒子参数：通过FloatPayload事件，可以实时控制粒子系统的发射速率、大小、颜色等参数（ParticleSystem.main.startSpeed = koreoEvent.GetFloatValue()），创建复杂的音乐可视化效果。

6. 常见问题与调试技巧实录

在实际开发中，你一定会遇到各种问题。以下是我总结的一些典型“坑”和解决方法。

6.1 事件没有触发

这是最常见的问题。请按以下清单排查：

1. 检查关联：确保播放音频的GameObject上的Koreographer Component正确关联了Koreography资产，并且该资产包含了你要监听的事件轨道。
2. 检查播放状态：音乐是否真的在播放？检查Koreographer Component的Play On Awake或确认你通过代码调用了Koreographer.Instance.Play()。
3. 检查监听注册：如果是代码监听，确认RegisterForEvents被成功调用（在Start或OnEnable中）。检查事件轨道名称字符串是否完全匹配（大小写敏感）。
4. 检查事件时间：你标记的事件时间点是否在音乐开始播放之后？如果事件标记在0秒，而音乐从第5秒开始播放，这个事件就不会被触发。
5. 检查Payload类型：如果你用koreoEvent.GetIntValue()去读取一个FloatPayload的事件，会得到0。确保读取方式与事件类型匹配。

6.2 事件触发时机不准

1. 确认延迟补偿：尝试启用/禁用Audio Latency Compensation，并调整其数值，观察变化。
2. 检查音频文件：确保导入Unity的音频文件格式正确（推荐.wav或.ogg），并且Load Type设置为Decompress On Load（对于短音乐）或Compressed In Memory（对于长音乐），避免Streaming带来的潜在延迟。Preload Audio Data需要勾选。
3. 使用Debug.Log记录时间：在事件回调中打印Time.time和事件的理论时间，对比差异。这能帮你判断是全局延迟还是单个事件问题。

6.3 多段音乐/动态切换音乐

1. 一个Koreographer Component对应一段音乐：要切换音乐，你可以准备多个Koreographer Component，通过启用/禁用它们来切换。或者，更常见的是，动态更换同一个Component上的Koreography资产和AudioClip，然后调用Koreographer.Instance.Play()重新开始。
2. 事件监听器的生命周期：当切换音乐时，旧音乐的事件可能还会错误地触发。务必在切换前，取消注册所有对旧音乐轨道的监听，然后注册对新轨道的监听。
3. 平滑过渡：如果需要两段音乐淡入淡出，你需要同时控制两个AudioSource的音量，并管理两套事件系统。这比较复杂，通常需要自己封装一个更高级的音乐管理器。

6.4 在移动设备上的特殊问题

1. 后台播放：默认情况下，iOS/Android应用切到后台时，音频会暂停。如果你希望音乐游戏在后台也能继续（比如计分），需要在Player Settings中设置相应的后台运行模式，并处理应用焦点的变化，手动暂停/恢复Koreographer。
2. 性能分析：在真机上使用Profiler，观察Koreographer.Update（或类似名称）的CPU占用。正常情况下应该极低。如果偏高，检查是否注册了过多不必要的事件监听器。
3. 内存：确保未使用的Koreography资产被正确卸载，特别是对于关卡制的游戏。

最后，分享一个调试利器：Koreographer自带一个Koreographer Debug Display组件。把它加到场景里，运行游戏时，它会在屏幕一角显示当前播放的音乐信息、即将触发的事件等，对于实时调试事件触发时机和Payload值非常有帮助。