Unity 3D平台游戏音乐分段循环切换技术问题求助

需求回顾 #

• 未触发Checkpoint时：30秒音乐段落循环播放
• 触发Checkpoint后：等待当前音乐段落自然结束，再切换至下一段，实现流畅过渡
• 过早触发Checkpoint：播放磁带停止音效后，再切换到下一段；当前代码存在「触发过晚仍会直接切断音乐」的问题

现有代码问题分析 #

1. 触发碰撞时立刻执行loopEnd.Stop();，直接切断当前音乐，未等待段落结束
2. 用浮点数（0.5f、1、2.5f、3）表示状态，易混淆且维护成本高
3. 协程定义在方法内部，可读性差

解决方案 #

1. 用枚举替代浮点数管理状态 #

先定义清晰的音乐状态枚举，避免状态值混乱：

public enum MusicState
{
    LoopingInitial,   // 未触发Checkpoint，循环初始段落
    EarlyTrigger,     // 过早触发Checkpoint
    WaitingForEnd,    // 等待当前段落结束
    PlayingNextLoop   // 播放下一段落
}

2. 重构触发逻辑与协程 #

核心思路：触发Checkpoint时，先判断当前段落剩余播放时间，再决定是播放停止音效还是等待段落结束后切换。

完整修正代码：

using UnityEngine;
using System.Collections;

public class CheckpointMusicTrigger : MonoBehaviour
{
    public AudioSource currentLoopSource; // 当前播放的段落音频源
    public AudioSource nextLoopSource;    // 下一段落音频源
    public AudioSource stopSoundSource;   // 磁带停止音效源
    public float loopDuration = 30f;      // 单段落时长

    [SerializeField] private float internalloop; // 编辑器状态监控变量

    private void OnTriggerEnter(Collider other)
    {
        // 仅响应玩家触发，需给玩家添加"Player"标签
        if (!other.CompareTag("Player")) return;

        var currentState = (MusicState)MusicLoop.loopEnd;
        if (currentState != MusicState.LoopingInitial) return;

        float remainingTime = loopDuration - currentLoopSource.time;
        // 剩余时间大于1秒判定为过早触发，可根据需求调整阈值
        if (remainingTime > 1f)
        {
            StartCoroutine(HandleEarlyTrigger());
        }
        else
        {
            StartCoroutine(WaitForLoopEndThenSwitch());
        }
    }

    // 处理过早触发逻辑
    private IEnumerator HandleEarlyTrigger()
    {
        currentLoopSource.Stop();
        stopSoundSource.Play();
        
        yield return new WaitForSeconds(0.8f);
        
        MusicLoop.loopEnd = (float)MusicState.PlayingNextLoop;
        nextLoopSource.Play();
        
        yield return new WaitForSeconds(loopDuration);
        // 可根据需求设置下一段的循环逻辑，比如：
        // MusicLoop.loopEnd = (float)MusicState.LoopingNext;
    }

    // 等待当前段落结束后切换
    private IEnumerator WaitForLoopEndThenSwitch()
    {
        MusicLoop.loopEnd = (float)MusicState.WaitingForEnd;
        // 等待当前段落剩余播放时间
        yield return new WaitForSeconds(currentLoopSource.clip.length - currentLoopSource.time);
        
        currentLoopSource.Stop();
        MusicLoop.loopEnd = (float)MusicState.PlayingNextLoop;
        nextLoopSource.Play();
        
        yield return new WaitForSeconds(loopDuration);
        // 后续状态处理
    }

    private void Update()
    {
        internalloop = MusicLoop.loopEnd;
    }
}

3. 优化MusicLoop管理类 #

建议直接在MusicLoop中使用枚举维护状态，替代原浮点数：

public static class MusicLoop
{
    public static MusicState loopEnd = MusicState.LoopingInitial;
}

关键改进点 #

• 移除了立刻停止音乐的逻辑，等待段落自然结束后切换，解决了「触发过晚切断音乐」的问题
• 通过剩余播放时间区分过早触发与接近段落结束的场景，符合需求逻辑
• 用枚举管理状态，代码可读性与可维护性大幅提升
• 增加玩家标签判断，避免非玩家对象误触发

内容的提问来源于stack exchange，提问作者Christian Lackner