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);
 
   static _<IAudioPlayer> fromUrl(AUrl url);
   enum class PlaybackStatus : int8_t {
       PLAYING,
       PAUSED,
       STOPPED
   };

   void play();

   void pause();

   void stop();

   PlaybackStatus playbackStatus() const noexcept {
       return mPlaybackStatus;
   }

   [[nodiscard]]
   const _<ASoundResampler>& resampledStream() const noexcept {
       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 != nullptr;
   }
 
   void initialize();
 
   void initializeIfNeeded() {
       if (!isInitialized()) {
           initialize();
       }
   }
 
   void release();
 
private:
   aui::audio::VolumeLevel mVolume = aui::audio::VolumeLevel::MAX;
   AUrl mUrl;
   _<ISoundInputStream> mSourceStream;
   _<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.