mgl_audio_source_instance.h

[詳解]

// SPDX-License-Identifier: Zlib
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
 
#ifndef INCGUARD_MGL_AUDIO_SOURCE_INSTANCE_H_1610735558
#define INCGUARD_MGL_AUDIO_SOURCE_INSTANCE_H_1610735558
 
#include <atomic>
 
#include <mgl/audio/mgl_audio_fade.h>
#include <mgl/audio/voice/mgl_audio_voice.h>
#include <mgl/mgl_environment.h>
 
namespace MGL::Audio
{
class SourceInstance
{
public:
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    SourceInstance(SharedVoice &voice, bool isAutoRemove) noexcept;
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    ~SourceInstance() noexcept
    {
        _voice->Stop();
    }
 
    bool Play(uint32_t trackIndex, LoopType loopType, float volume) noexcept;
    bool Update(float &outDataL, float &outDataR) noexcept;
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Pause(bool isEnabled) noexcept
    {
        _isPaused = isEnabled;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    bool IsPaused() const noexcept
    {
        return _isPaused;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Remove() noexcept
    {
        const std::lock_guard<std::mutex> lock(_mutex);
 
        _status = Status::Remove;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void SetVolume(float volume) noexcept
    {
        const std::lock_guard<std::mutex> lock(_mutex);
 
        _fade.Cancel();
        _volume = volume;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void SetVolume(float volume, float fadeTimeSec, float samplesPerSec, bool isAutoStop) noexcept
    {
        const std::lock_guard<std::mutex> lock(_mutex);
 
        _fade.Start(_volume, volume, fadeTimeSec, samplesPerSec, isAutoStop);
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    float GetVolume() const noexcept
    {
        return _volume;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    bool IsPlaying() const noexcept
    {
        return _status == Status::Play;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    constexpr bool IsFading() const noexcept
    {
        return _fade.IsActive();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void SetAutoRemove(bool isEnabled) noexcept
    {
        _isAutoRemove = isEnabled;
    }
 
private:
    SharedVoice _voice;
 
    uint32_t _trackIndex{0};
    size_t _currentFrame{0};
    std::atomic<LoopType> _loopType{LoopType::ResourceDefault};
 
    std::atomic<bool> _isAutoRemove;
    std::atomic<bool> _isPaused{false};
    std::atomic<float> _volume{0.0f};
 
    enum class Status : uint8_t
    {
        Standby,    
        Play,       
        Remove      
    };
    std::atomic<Status> _status{Status::Standby};
 
    Fade _fade;
 
    std::mutex _mutex;
};
 
using SharedSourceInstance = std::shared_ptr<SourceInstance>;
 
using WeakSourceInstance = std::weak_ptr<SourceInstance>;
 
}    // namespace MGL::Audio
 
#endif    // INCGUARD_MGL_AUDIO_SOURCE_INSTANCE_H_1610735558
 
// vim: et ts=4 sw=4 sts=4