SDL Mixer调用PlayChannel()无声音且无法完整播放问题求助

问题描述 #

我用C++封装SDL Mixer类实现应用音频播放，但调用Mix_PlayChannel()时听不到声音，且声音无法完整播放。已通过打印MixChunk成员变量确认声音加载正常、音量设为最大，尝试过usleep()或SDL_Delay()等待播放完毕也无效，每次调用仅在音频混音器中短暂出现。之前把所有函数放在全局作用域时程序运行正常。

类实现代码 #

//Standard libraries used
#include<unordered_map>
#include<vector>

//Include classes for the library
#include "classes/s_soundData.h"
#include "classes/s_soundController.h"
#include "classes/s_soundPlaylist.h"

//SDL
#include<SDL2/SDL.h>
#include<SDL2/SDL_mixer.h>

class mySoundClass
{
    public:

        /*** Member variables ***/
        unordered_map<std::string, unordered_map<std::string, s_soundData>> sounds; //Container of all sounds
        unordered_map<std::string, s_soundPlaylist> playlists; //Contains all of the playlists created with the stevensSound library
        unordered_map<std::string, s_soundController> soundControllers; //Container of all sound controllers. Controls volume and playback settings for sounds.

        /*** Constructors ***/

        //Default constructor
        mySoundClass()
        {
            //Initialize SDL
            if( SDL_Init( SDL_INIT_VIDEO | SDL_INIT_AUDIO ) < 0 )
            {
                printf( "SDL could not initialize! SDL Error: %s\n", SDL_GetError() );
            }

            //Initialize SDL_mixer
            if( Mix_OpenAudio( 44100, MIX_DEFAULT_FORMAT, 2, 2048 ) < 0 )
            {
                printf( "SDL_mixer could not initialize! SDL_mixer Error: %s\n", Mix_GetError() );
            }

            //Create music, sfx, and default sound controllers
            soundControllers = {    {"music",   s_soundController("music",1)},
                                    {"sfx",     s_soundController("sfx",1)},
                                    {"default", s_soundController()}    };

            //With no parameters, we just initialize our sound container to be empty
            sounds = {};

            //Also initialize our playlists container to be empty
            playlists = {};
        }


        /*** Destructor ***/
        ~ mySoundClass()
        {
            //Quit SDL subsystems on destruction
            Mix_Quit();
            SDL_Quit();
        }


        /*** Methods ***/
        void playSound( std::string soundName,
                        std::string category    )
        /*
          Plays a sound effect using the SDL library's functions
            
        */
        {
            //Get the sound's data and its controller
            s_soundData soundData = sounds[category][soundName];
            s_soundController soundController = soundControllers[soundData.controllerId];
            //Load the sound file into memory
            Mix_Chunk* sound = NULL;
            sound = Mix_LoadWAV(soundData.filePath);
            //Control the playback
            Mix_VolumeChunk(sound, (int)round(128 * soundController.volume));
            //Play the sound
            Mix_PlayChannel( -1, sound, 0 );
        }
};

问题分析 #

1. 局部变量销毁导致音频数据丢失：playSound方法中的Mix_Chunk* sound是局部指针，方法执行完毕后该指针被销毁，SDL Mixer还未完成播放就丢失了音频数据，这是无声音的核心原因。
2. 重复加载资源效率低下：每次调用playSound都重新加载WAV文件，不仅浪费资源，还可能引发内存泄漏。
3. 不必要的对象拷贝：直接拷贝s_soundData和s_soundController会触发额外的复制操作，应该使用引用优化。

修复方案 #

1. 添加成员变量存储已加载的音频块 #

在mySoundClass中新增成员变量，避免重复加载和局部变量销毁问题：

// 在mySoundClass的成员变量区域添加
unordered_map<std::string, unordered_map<std::string, Mix_Chunk*>> loadedSounds;

2. 实现音频预加载方法 #

提前加载音频文件（也可在首次播放时加载）：

// 在mySoundClass的Methods区域添加
void loadSound(std::string soundName, std::string category, std::string filePath, std::string controllerId = "default") {
    if (loadedSounds[category].find(soundName) == loadedSounds[category].end()) {
        Mix_Chunk* chunk = Mix_LoadWAV(filePath.c_str());
        if (chunk != nullptr) {
            loadedSounds[category][soundName] = chunk;
            sounds[category][soundName] = s_soundData(filePath, controllerId);
        } else {
            printf("Failed to load sound! Mix Error: %s\n", Mix_GetError());
        }
    }
}

3. 修改playSound方法 #

使用已加载的音频块，避免局部变量销毁：

void playSound(std::string soundName, std::string category) {
    // 使用引用避免不必要的拷贝
    s_soundData& soundData = sounds[category][soundName];
    s_soundController& soundController = soundControllers[soundData.controllerId];
    
    auto soundIter = loadedSounds[category].find(soundName);
    if (soundIter != loadedSounds[category].end()) {
        Mix_Chunk* sound = soundIter->second;
        Mix_VolumeChunk(sound, (int)round(128 * soundController.volume));
        
        // 检查播放是否成功
        int channel = Mix_PlayChannel(-1, sound, 0);
        if (channel == -1) {
            printf("Failed to play sound! Mix Error: %s\n", Mix_GetError());
        }
    } else {
        printf("Sound not preloaded: %s/%s\n", category.c_str(), soundName.c_str());
    }
}

4. 完善析构函数释放资源 #

确保所有已加载的音频块被正确释放：

~mySoundClass() {
    // 释放所有加载的音频资源
    for (auto& categoryPair : loadedSounds) {
        for (auto& soundPair : categoryPair.second) {
            Mix_FreeChunk(soundPair.second);
        }
    }
    Mix_Quit();
    SDL_Quit();
}

额外提示 #

• 构造函数中如果SDL或SDL Mixer初始化失败，建议添加错误处理逻辑（如终止程序或抛出异常），避免后续无效操作。
• 播放音频后，确保主程序不会立即退出（比如在main函数中添加SDL_Delay()保持运行，或处理事件循环），给音频播放留足时间。
• 检查系统音频设备是否正常，以及SDL Mixer库是否正确链接。

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