AudioPlaylist.h

Go to the documentation of this file.

#pragma once
#include "HephAudioShared.h"
#include "AudioStream.h"
#include "AudioEvents/AudioRenderEventArgs.h"
#include "AudioEvents/AudioRenderEventResult.h"
#include "AudioEvents/AudioFinishedPlayingEventArgs.h"
#include "EventArgs.h"
#include "EventResult.h"
#include <string>
#include <vector>
 
#define HEPHAUDIO_PLAYLIST_EVENT_USER_ARG_KEY "audio_playlist"
 
namespace HephAudio
{
    class HEPH_API AudioPlaylist final
    {
    public:
        enum TransitionEffect : uint8_t
        {
            None,
            Delay,
            Fade,
            FadeIn,
            FadeOut
        };
 
    private:
        AudioStream stream;
        std::vector<std::filesystem::path> files;
        bool isPaused;
        bool applyFadeInOrDelay;
        TransitionEffect transitionEffect;
        double transitionDuration_s;
 
    public:
        AudioPlaylist(Native::NativeAudio* pNativeAudio);
        AudioPlaylist(Audio& audio);
 
        AudioPlaylist(Native::NativeAudio* pNativeAudio, const std::vector<std::filesystem::path>& files);
 
        AudioPlaylist(Audio& audio, const std::vector<std::filesystem::path>& files);
 
        AudioPlaylist(Native::NativeAudio* pNativeAudio, TransitionEffect transitionEffect, double transitionDuration_s);
 
        AudioPlaylist(Audio& audio, TransitionEffect transitionEffect, double transitionDuration_s);
    
        AudioPlaylist(Native::NativeAudio* pNativeAudio, TransitionEffect transitionEffect, double transitionDuration_s, const std::vector<std::filesystem::path>& files);
    
        AudioPlaylist(Audio& audio, TransitionEffect transitionEffect, double transitionDuration_s, const std::vector<std::filesystem::path>& files);
        
        AudioPlaylist(const AudioPlaylist&) = delete;
        
        AudioPlaylist(AudioPlaylist&& rhs) noexcept;
        
        AudioPlaylist& operator=(const AudioPlaylist&) = delete;
        AudioPlaylist& operator=(const std::filesystem::path& rhs);
        AudioPlaylist& operator=(const std::vector<std::filesystem::path>& rhs);
        AudioPlaylist& operator=(AudioPlaylist&& rhs) noexcept;
 
        size_t Size() const;
 
        Native::NativeAudio* GetNativeAudio() const;
 
        TransitionEffect GetTransitionEffect() const;
 
        void SetTransitionEffect(TransitionEffect transitionEffect);
 
        double GetTransitionDuration() const;
 
        void SetTransitionDuration(double transitionDuration_s);
 
        void Start();
 
        void Stop();
 
        bool IsPaused() const;
 
        void Add(const std::filesystem::path& filePath);
 
        void Add(const std::vector<std::filesystem::path>& files);
 
        void Insert(const std::filesystem::path& filePath, size_t index);
 
        void Insert(const std::vector<std::filesystem::path>& files, size_t index);
 
        void Remove(size_t index);
 
        void Remove(size_t index, size_t count);
 
        void Remove(const std::filesystem::path& filePath);
 
        void Skip();
 
        void Skip(size_t n);
 
        void Clear();
 
    private:
        void ChangeFile();
        static void OnFinishedPlaying(const Heph::EventParams& eventParams);
        static void ApplyTransitionEffect(const Heph::EventParams& eventParams);
        static void Transition_Delay(AudioPlaylist* pPlaylist, AudioRenderEventArgs* pRenderArgs, AudioRenderEventResult* pRenderResult);
        static void Transition_FadeIn(AudioPlaylist* pPlaylist, AudioRenderEventArgs* pRenderArgs, AudioRenderEventResult* pRenderResult);
        static void Transition_FadeOut(AudioPlaylist* pPlaylist, AudioRenderEventArgs* pRenderArgs, AudioRenderEventResult* pRenderResult);
    };
}