mgl_audio_source.h

[詳解]

// SPDX-License-Identifier: Zlib
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
 
#ifndef INCGUARD_MGL_AUDIO_SOURCE_H_1610744589
#define INCGUARD_MGL_AUDIO_SOURCE_H_1610744589
 
#include <mgl/audio/mgl_audio_player.h>
#include <mgl/audio/mgl_audio_source_instance.h>
#include <mgl/mgl_environment.h>
 
namespace MGL::Audio
{
class Source
{
public:
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    Source(const SharedSourceInstance &sourceInstance) noexcept
        : _sourceInstance(sourceInstance)
    {
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    constexpr Source() noexcept = default;
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    Source(VoiceKey voiceKey, bool isAutoRemove = true) noexcept
        : Source()
    {
        Attach(voiceKey, isAutoRemove);
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    ~Source() noexcept
    {
        Detach();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    bool Attach(VoiceKey voiceKey, bool isAutoRemove) noexcept
    {
        Detach();
        _sourceInstance = Player::GetInstance().MakeSourceInstance(voiceKey, isAutoRemove);
 
        return true;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Detach() noexcept
    {
        if (auto source = _sourceInstance.lock(); source != nullptr)
        {
            if (!source->IsPlaying() || source->IsPaused())
            {
                source->Remove();
            }
            else
            {
                source->SetAutoRemove(true);
            }
 
            _sourceInstance = WeakSourceInstance();
        }
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] bool IsAttached() const noexcept
    {
        return !_sourceInstance.expired();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    bool Play(VoiceKey voiceKey, bool isAutoRemove = true, uint32_t trackIndex = 0, LoopType loopType = LoopType::ResourceDefault, float volume = 1.0f) noexcept
    {
        if (!Attach(voiceKey, isAutoRemove))
        {
            return false;
        }
 
        return Play(trackIndex, loopType, volume);
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    bool Play(uint32_t trackIndex = 0, LoopType loopType = LoopType::ResourceDefault, float volume = 1.0f) noexcept
    {
        if (auto source = _sourceInstance.lock(); source != nullptr)
        {
            return source->Play(trackIndex, loopType, volume);
        }
 
        return false;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Pause(bool isEnabled = true) noexcept
    {
        if (auto source = _sourceInstance.lock(); source != nullptr)
        {
            source->Pause(isEnabled);
        }
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Resume() noexcept
    {
        Pause(false);
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] bool IsPaused() const noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            return source->IsPaused();
        }
 
        return false;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Stop() noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            source->Remove();
            _sourceInstance = WeakSourceInstance();
        }
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void SetVolume(float volume) noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            source->SetVolume(volume);
        }
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void SetVolume(float volume, float fadeTimeSec, bool isAutoStop = false) noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            auto samplesPerSec = Player::GetInstance().GetOutputFormat().samplesPerSec;
            source->SetVolume(volume, fadeTimeSec, samplesPerSec, isAutoStop);
        }
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    void Fadeout(float fadeTimeSec, bool isAutoStop = true) noexcept
    {
        SetVolume(0.0f, fadeTimeSec, isAutoStop);
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] float GetVolume() const noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            return source->GetVolume();
        }
 
        return 0.0f;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] bool IsPlaying() const noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            return source->IsPlaying();
        }
 
        return false;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] bool IsFading() const noexcept
    {
        if (const auto source = _sourceInstance.lock(); source != nullptr)
        {
            return source->IsFading();
        }
 
        return false;
    }
 
    // コピー禁止
    Source(const Source &) = delete;
    Source &operator=(const Source &) = delete;
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    Source(Source &&other) noexcept
        : _sourceInstance(std::move(other._sourceInstance))
    {
        other._sourceInstance = WeakSourceInstance();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    Source &operator=(Source &&other) noexcept
    {
        if (this != &other)
        {
            Detach();
            _sourceInstance = std::move(other._sourceInstance);
            other._sourceInstance = WeakSourceInstance();
        }
 
        return *this;
    }
 
private:
    WeakSourceInstance _sourceInstance;
};
}    // namespace MGL::Audio
#endif    // INCGUARD_MGL_AUDIO_SOURCE_H_1610744589
 
// vim: et ts=4 sw=4 sts=4