IAudioPlayer.h

#pragma once
 
#include <AUI/Common/AObject.h>
#include <AUI/Common/ASignal.h>
#include <AUI/Url/AUrl.h>
#include <AUI/Audio/ASoundResampler.h>
#include <AUI/Audio/VolumeLevel.h>

class API_AUI_AUDIO IAudioPlayer: public AObject {
public:
   explicit IAudioPlayer(AUrl url);
   explicit IAudioPlayer(_<ISoundInputStream> stream);
 
   static _<IAudioPlayer> fromUrl(AUrl url);
   static _<IAudioPlayer> fromStream(_<ISoundInputStream> stream);

   enum class PlaybackStatus : int8_t {
       PLAYING,
       PAUSED,
       STOPPED
   };

   void play();

   void pause();

   void stop();

   PlaybackStatus playbackStatus() const noexcept {
       return mPlaybackStatus;
   }

   [[nodiscard]]
   ASoundResampler& resampledStream() {
       return *mResampledStream;
   }

   void setLoop(bool loop);

   [[nodiscard]]
   bool loop() const noexcept {
       return mLoop;
   }

   void setVolume(aui::audio::VolumeLevel volume);

   [[nodiscard]]
   aui::audio::VolumeLevel volume() const noexcept {
       return mVolume;
   }

   void onFinished();
 
   const AUrl& url() const noexcept {
       return *mUrl;
   }
 
   void rewind();
 
signals:
   emits<> finished;

   emits<> read;
 
protected:
   bool isInitialized() const noexcept {
       return mResampledStream != std::nullopt;
   }
 
   void initialize();
 
   void initializeIfNeeded() {
       if (!isInitialized()) {
           initialize();
       }
   }
 
   void reset();
 
private:
   aui::audio::VolumeLevel mVolume = aui::audio::VolumeLevel::MAX;
   AOptional<AUrl> mUrl;
   _<ISoundInputStream> mSourceStream;
   AOptional<ASoundResampler> mResampledStream;
   PlaybackStatus mPlaybackStatus = PlaybackStatus::STOPPED;
   bool mLoop = false;
 
   virtual void playImpl() = 0;
   virtual void pauseImpl() = 0;
   virtual void stopImpl() = 0;
 
   virtual void onVolumeSet() { }
   virtual void onLoopSet() { }
};

© 2025 AUI Framework Contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.