115 lines
5.9 KiB
C++
115 lines
5.9 KiB
C++
#pragma once
|
||
|
||
#include <cstdint> // Para int8_t, uint8_t
|
||
#include <string> // Para string
|
||
#include <utility> // Para move
|
||
|
||
// --- Clase Audio: gestor de audio (singleton) ---
|
||
// Implementació canònica, byte-idèntica entre projectes.
|
||
// Els volums es manegen internament com a float 0.0–1.0; la capa de
|
||
// presentació (menús, notificacions) usa les helpers toPercent/fromPercent
|
||
// per mostrar 0–100 a l'usuari.
|
||
class Audio {
|
||
public:
|
||
// --- Enums ---
|
||
enum class Group : std::int8_t {
|
||
ALL = -1, // Todos los grupos
|
||
GAME = 0, // Sonidos del juego
|
||
INTERFACE = 1 // Sonidos de la interfaz
|
||
};
|
||
|
||
enum class MusicState : std::uint8_t {
|
||
PLAYING, // Reproduciendo música
|
||
PAUSED, // Música pausada
|
||
STOPPED, // Música detenida
|
||
};
|
||
|
||
// --- Constantes ---
|
||
static constexpr float MAX_VOLUME = 1.0F; // Volumen máximo (float 0..1)
|
||
static constexpr float MIN_VOLUME = 0.0F; // Volumen mínimo (float 0..1)
|
||
static constexpr float VOLUME_STEP = 0.05F; // Pas estàndard per a UI (5%)
|
||
static constexpr int FREQUENCY = 48000; // Frecuencia de audio
|
||
static constexpr int DEFAULT_CROSSFADE_MS = 1500; // Duració del crossfade per defecte (ms)
|
||
|
||
// --- Singleton ---
|
||
static void init(); // Inicializa el objeto Audio
|
||
static void destroy(); // Libera el objeto Audio
|
||
static auto get() -> Audio*; // Obtiene el puntero al objeto Audio
|
||
Audio(const Audio&) = delete; // Evitar copia
|
||
auto operator=(const Audio&) -> Audio& = delete; // Evitar asignación
|
||
|
||
static void update(); // Actualización del sistema de audio
|
||
|
||
// --- Control de música ---
|
||
void playMusic(const std::string& name, int loop = -1, int crossfade_ms = 0); // Reproducir música por nombre (con crossfade opcional)
|
||
void playMusic(struct JA_Music_t* music, int loop = -1, int crossfade_ms = 0); // Reproducir música por puntero (con crossfade opcional)
|
||
void pauseMusic(); // Pausar reproducción de música
|
||
void resumeMusic(); // Continua la música pausada
|
||
void stopMusic(); // Detener completamente la música
|
||
void fadeOutMusic(int milliseconds) const; // Fundido de salida de la música
|
||
|
||
// --- Control de sonidos ---
|
||
void playSound(const std::string& name, Group group = Group::GAME) const; // Reproducir sonido puntual por nombre
|
||
void playSound(struct JA_Sound_t* sound, Group group = Group::GAME) const; // Reproducir sonido puntual por puntero
|
||
void stopAllSounds() const; // Detener todos los sonidos
|
||
|
||
// --- Control de volumen (API interna: float 0.0..1.0) ---
|
||
void setSoundVolume(float volume, Group group = Group::ALL) const; // Ajustar volumen de efectos
|
||
void setMusicVolume(float volume) const; // Ajustar volumen de música
|
||
|
||
// --- Helpers de conversió per a la capa de presentació ---
|
||
// UI (menús, notificacions) manega enters 0..100; internament viu float 0..1.
|
||
static constexpr auto toPercent(float volume) -> int {
|
||
return static_cast<int>(volume * 100.0F + 0.5F);
|
||
}
|
||
static constexpr auto fromPercent(int percent) -> float {
|
||
return static_cast<float>(percent) / 100.0F;
|
||
}
|
||
|
||
// --- Configuración general ---
|
||
void enable(bool value); // Establecer estado general
|
||
void toggleEnabled() { enabled_ = !enabled_; } // Alternar estado general
|
||
void applySettings(); // Aplica la configuración
|
||
|
||
// --- Configuración de sonidos ---
|
||
void enableSound() { sound_enabled_ = true; } // Habilitar sonidos
|
||
void disableSound() { sound_enabled_ = false; } // Deshabilitar sonidos
|
||
void enableSound(bool value) { sound_enabled_ = value; } // Establecer estado de sonidos
|
||
void toggleSound() { sound_enabled_ = !sound_enabled_; } // Alternar estado de sonidos
|
||
|
||
// --- Configuración de música ---
|
||
void enableMusic() { music_enabled_ = true; } // Habilitar música
|
||
void disableMusic() { music_enabled_ = false; } // Deshabilitar música
|
||
void enableMusic(bool value) { music_enabled_ = value; } // Establecer estado de música
|
||
void toggleMusic() { music_enabled_ = !music_enabled_; } // Alternar estado de música
|
||
|
||
// --- Consultas de estado ---
|
||
[[nodiscard]] auto isEnabled() const -> bool { return enabled_; }
|
||
[[nodiscard]] auto isSoundEnabled() const -> bool { return sound_enabled_; }
|
||
[[nodiscard]] auto isMusicEnabled() const -> bool { return music_enabled_; }
|
||
[[nodiscard]] auto getMusicState() const -> MusicState { return music_.state; }
|
||
[[nodiscard]] static auto getRealMusicState() -> MusicState;
|
||
[[nodiscard]] auto getCurrentMusicName() const -> const std::string& { return music_.name; }
|
||
|
||
private:
|
||
// --- Tipos anidados ---
|
||
struct Music {
|
||
MusicState state{MusicState::STOPPED}; // Estado actual de la música
|
||
std::string name; // Última pista de música reproducida
|
||
bool loop{false}; // Indica si se reproduce en bucle
|
||
};
|
||
|
||
// --- Métodos ---
|
||
Audio(); // Constructor privado
|
||
~Audio(); // Destructor privado
|
||
void initSDLAudio(); // Inicializa SDL Audio
|
||
|
||
// --- Variables miembro ---
|
||
static Audio* instance; // Instancia única de Audio
|
||
|
||
Music music_; // Estado de la música
|
||
bool enabled_{true}; // Estado general del audio
|
||
bool sound_enabled_{true}; // Estado de los efectos de sonido
|
||
bool music_enabled_{true}; // Estado de la música
|
||
};
|