dl_audio.h

浏览该文件的文档.

#pragma once
 
#ifndef DL_DISABLE_AUDIO
#include <unordered_map>
 
#include "memory/dl_memory_pool.h"
#include "io/dl_json.h"
 
namespace dl
{

constexpr size_t NUM_MAX_FILE = 256;
 
class SoundImp;
class Sound
{
    friend class Audio;
    friend class PoolList<Sound>;
    using ID = unsigned;
public:
    void Play();
    void Stop();
    void SetLoop(bool loop);

    void SetVolume(float volume);
    bool IsPlaying();
 
    ~Sound();
 
private:
    Sound();
    ID _source;
    bool _deleteWaitStop;// 删除时，等待播完
};
using gcSound = GC<Sound>;
 
class AudioImp;
class Audio
{
    friend class System;
public:
    Audio(bool open);
    void Init(std::string_view path_name);
    bool IsOpen() { return _bOpen; }
    void SetPath(std::string_view path)
    {
        _bSetPath = true;
        _strPath = path;
    }

    void SetWhitelist(const std::vector<std::string>& vec_load)
    {
        _vecWhitelist = vec_load;
    }

    void Load(std::string_view name, std::string_view path_name);

    std::vector<std::string> GetAllSound();

    gcSound Create(std::string_view name);
 
    gcSound CreateDefault()
    {
        return get_gc<Sound>();
    }

    void _load();
 
    void _delete_sound(Sound* snd);
 
    ~Audio();
private:
    AudioImp* _imp;
    bool _bSetPath;
    bool _bOpen; // 初始化前手动关闭，或声音设备不存在时设置
    std::string _strPath;
    std::vector<std::string> _vecWhitelist;
    // name -> buffer下标
    std::unordered_map<std::string, size_t> _mapName2Buffer;
    // 删除列表（延迟删除）
    std::list<Sound::ID> _listDelete;
};
 
extern Audio* g_audio;

inline gcSound snd_play(std::string_view name, size_t group_id = 0, float volume = 1.0f)
{
    gcSound voc = g_audio->Create(name);
    if (!voc)
    {
        log_err("音效创建失败：{}", name);
        return g_audio->CreateDefault();
    }
 
    voc->SetVolume(volume);
    voc->Play();
    return voc;
}
 
}
#else
#include <string_view>
namespace dl
{
    inline void snd_play(std::string_view name, size_t group_id = 0, float volume = 1.0f)
    {
    }
}
 
#endif