mirror of
https://github.com/Kelsidavis/WoWee.git
synced 2026-03-23 07:40:14 +00:00
9d1616a11b
Add AudioEngine::playSound2DStoppable() + stopSound() so callers can hold a handle and cancel playback early. SpellSoundManager::playPrecast() now stores the handle in activePrecastId_; stopPrecast() cuts the sound. playCast() calls stopPrecast() before playing the release sound, so the channeling audio never bleeds past cast time. SMSG_SPELL_FAILURE and SMSG_CAST_FAILED both call stopPrecast() so interrupted casts silence immediately.
102 lines
3.5 KiB
C++
102 lines
3.5 KiB
C++
#pragma once
|
|
|
|
#include <glm/glm.hpp>
|
|
#include <memory>
|
|
#include <string>
|
|
#include <vector>
|
|
#include <cstdint>
|
|
|
|
// Forward declare miniaudio types to avoid exposing implementation in header
|
|
struct ma_engine;
|
|
struct ma_sound;
|
|
|
|
namespace wowee {
|
|
namespace pipeline { class AssetManager; }
|
|
namespace audio {
|
|
|
|
/**
|
|
* AudioEngine: Singleton managing miniaudio device and playback.
|
|
* Replaces process-spawning audio system with proper non-blocking library.
|
|
*/
|
|
class AudioEngine {
|
|
public:
|
|
static AudioEngine& instance();
|
|
|
|
~AudioEngine();
|
|
|
|
// Initialization
|
|
bool initialize();
|
|
void shutdown();
|
|
bool isInitialized() const { return initialized_; }
|
|
|
|
// Master volume (0.0 = silent, 1.0 = full)
|
|
void setMasterVolume(float volume);
|
|
float getMasterVolume() const { return masterVolume_; }
|
|
|
|
// Asset manager (enables sound loading by MPQ path)
|
|
void setAssetManager(pipeline::AssetManager* am) { assetManager_ = am; }
|
|
|
|
// 3D listener position (for positional audio)
|
|
void setListenerPosition(const glm::vec3& position);
|
|
void setListenerOrientation(const glm::vec3& forward, const glm::vec3& up);
|
|
const glm::vec3& getListenerPosition() const { return listenerPosition_; }
|
|
|
|
// Simple 2D sound playback (non-blocking)
|
|
bool playSound2D(const std::vector<uint8_t>& wavData, float volume = 1.0f, float pitch = 1.0f);
|
|
bool playSound2D(const std::string& mpqPath, float volume = 1.0f, float pitch = 1.0f);
|
|
|
|
// Stoppable 2D sound — returns a non-zero handle, or 0 on failure
|
|
uint32_t playSound2DStoppable(const std::vector<uint8_t>& wavData, float volume = 1.0f);
|
|
// Stop a sound started with playSound2DStoppable (no-op if already finished)
|
|
void stopSound(uint32_t id);
|
|
|
|
// 3D positional sound playback
|
|
bool playSound3D(const std::vector<uint8_t>& wavData, const glm::vec3& position,
|
|
float volume = 1.0f, float pitch = 1.0f, float maxDistance = 100.0f);
|
|
bool playSound3D(const std::string& mpqPath, const glm::vec3& position,
|
|
float volume = 1.0f, float pitch = 1.0f, float maxDistance = 100.0f);
|
|
|
|
// Music streaming (for background music)
|
|
bool playMusic(const std::vector<uint8_t>& musicData, float volume = 1.0f, bool loop = true);
|
|
void stopMusic();
|
|
bool isMusicPlaying() const;
|
|
void setMusicVolume(float volume);
|
|
|
|
// Update (call once per frame for cleanup/position sync)
|
|
void update(float deltaTime);
|
|
|
|
private:
|
|
AudioEngine();
|
|
AudioEngine(const AudioEngine&) = delete;
|
|
AudioEngine& operator=(const AudioEngine&) = delete;
|
|
|
|
// Track active one-shot sounds for cleanup
|
|
struct ActiveSound {
|
|
ma_sound* sound;
|
|
void* buffer; // ma_audio_buffer* - Keep audio buffer alive
|
|
std::shared_ptr<const std::vector<uint8_t>> pcmDataRef; // Keep decoded PCM alive
|
|
uint32_t id = 0; // 0 = anonymous (not stoppable)
|
|
};
|
|
std::vector<ActiveSound> activeSounds_;
|
|
uint32_t nextSoundId_ = 1;
|
|
|
|
// Music track state
|
|
ma_sound* musicSound_ = nullptr;
|
|
void* musicDecoder_ = nullptr; // ma_decoder* - Keep decoder alive for streaming
|
|
std::vector<uint8_t> musicData_; // Keep encoded music data alive
|
|
float musicVolume_ = 1.0f;
|
|
|
|
bool initialized_ = false;
|
|
float masterVolume_ = 1.0f;
|
|
glm::vec3 listenerPosition_{0.0f, 0.0f, 0.0f};
|
|
glm::vec3 listenerForward_{0.0f, 0.0f, -1.0f};
|
|
glm::vec3 listenerUp_{0.0f, 1.0f, 0.0f};
|
|
|
|
pipeline::AssetManager* assetManager_ = nullptr;
|
|
|
|
// miniaudio engine (opaque pointer)
|
|
ma_engine* engine_ = nullptr;
|
|
};
|
|
|
|
} // namespace audio
|
|
} // namespace wowee
|