音频模块

结合ResMgr.ts，用ccc 3.8.x 内置 API 帮我们写一个AudioMgr.ts音频管理器，实现：
1、音乐播放、暂停、重播
2、音效播放
3、设置音乐音量
4、设置音效音量
5、加一个音效组件池，数量初始为5个，用于支持同时播放多个音效
6、参考ResMgr单例方式，并导出

import { Node, AudioSource, AudioClip, director, Director, find } from 'cc';
import { resMgr } from './ResMgr';
import { EDITOR } from 'cc/env';

/**
 * 音频管理器
 * 用于音乐和音效的播放、暂停、重播和音量设置
 */
class AudioMgr {
    private musicSource: AudioSource | null = null;
    private effectSources: AudioSource[] = [];
    private effectVolume: number = 1;
    private musicVolume: number = 1;
    private audioMgrNode: Node | null = null;

    // 私有构造函数，防止外部实例化
    private constructor() {
        director.once(Director.EVENT_AFTER_SCENE_LAUNCH, this.init, this);
    }

    /** 单例实例 */
    public static readonly instance: AudioMgr = new AudioMgr();

    private init() {
        if (EDITOR) return; // 在编辑器模式下不执行

        // 初始化音效组件池并添加到场景根节点
        this.audioMgrNode = new Node('__AudioMgr__');
        director.getScene().addChild(this.audioMgrNode);

        for (let i = 0; i < 5; i++) {
            const effectSource = this.audioMgrNode.addComponent(AudioSource);
            this.effectSources.push(effectSource);
        }
        this.musicSource = this.audioMgrNode.addComponent(AudioSource);
    }

    /**
     * 播放音乐
     * @param {string} bundleName - 分包名称
     * @param {string} url - 音乐资源路径
     * @param {boolean} loop - 是否循环播放
     * @param {number} volume - 音量值（0-1）
     */
    public playMusic(bundleName: string, url: string, loop: boolean = true, volume: number = 1) {
        resMgr.loadAsset(bundleName, url, AudioClip, (err, clip) => {
            if (err) {
                console.error(`加载音乐失败: ${url}`, err);
                return;
            }
            if (this.musicSource) {
                this.musicSource.clip = clip;
                this.musicSource.loop = loop;
                this.musicSource.volume = volume * this.musicVolume;
                this.musicSource.play();
            }
        });
    }

    /**
     * 暂停音乐
     */
    public pauseMusic() {
        if (this.musicSource) {
            this.musicSource.pause();
        }
    }

    /**
     * 重播音乐
     */
    public resumeMusic() {
        if (this.musicSource) {
            this.musicSource.play();
        }
    }

    /**
     * 播放音效
     * @param {string} bundleName - 分包名称
     * @param {string} url - 音效资源路径
     * @param {number} volume - 音量值（0-1）
     */
    public playEffect(bundleName: string, url: string, volume: number = 1) {
        resMgr.loadAsset(bundleName, url, AudioClip, (err, clip) => {
            if (err) {
                console.error(`加载音效失败: ${url}`, err);
                return;
            }
            const effectSource = this.getAvailableEffectSource();
            effectSource.clip = clip;
            effectSource.volume = volume * this.effectVolume;
            effectSource.play();
        });
    }

    /**
     * 设置音乐音量
     * @param {number} volume - 音量值（0-1）
     */
    public setMusicVolume(volume: number) {
        this.musicVolume = volume;
        if (this.musicSource) {
            this.musicSource.volume = volume * this.musicVolume;
        }
    }

    /**
     * 设置音效音量
     * @param {number} volume - 音量值（0-1）
     */
    public setEffectVolume(volume: number) {
        this.effectVolume = volume;
        this.effectSources.forEach(source => {
            source.volume = volume;
        });
    }

    /**
     * 获取可用的音效组件
     * @returns {AudioSource} 可用的音效组件
     */
    private getAvailableEffectSource(): AudioSource {
        for (const source of this.effectSources) {
            if (!source.playing) {
                return source;
            }
        }
        if (this.audioMgrNode) {
            const newSource = this.audioMgrNode.addComponent(AudioSource);
            this.effectSources.push(newSource);
            return newSource;
        } else {
            throw new Error('未找到音频管理节点，无法添加新的音效组件');
        }
    }
}

/** 导出实例 */
export const audioMgr = AudioMgr.instance;