using UnityEngine;

namespace BaseGames.Core
{
    /// <summary>
    /// 音频服务接口。
    /// 实现由 BaseGames.Audio 程序集提供；Core 层注册 NullAudioService 作为兜底。
    /// </summary>
    public interface IAudioService
    {
        /// <summary>播放背景音乐（循环）。key 对应 Addressables 地址或 Audio Mixer 键。</summary>
        void PlayBGM(string key);

        /// <summary>停止背景音乐。fadeTime > 0 则淡出。</summary>
        void StopBGM(float fadeTime = 0f);

        /// <summary>单次播放音效。</summary>
        void PlaySFX(string key);

        /// <summary>在世界坐标播放音效片段（用于 3D 音效）。</summary>
        void PlaySFXAtPosition(AudioClip clip, Vector2 position, float volumeScale = 1f);

        /// <summary>设置混音器音量（0–1）。group 取 AudioMixerKeys 常量。</summary>
        void SetVolume(string group, float normalizedVolume);
    }
}