Audio.h

Go to the documentation of this file.

#pragma once
#include "HephAudioShared.h"
#include "NativeAudio/NativeAudio.h"
#include "AudioEvents/AudioDeviceEventArgs.h"
#include "AudioEvents/AudioCaptureEventArgs.h"
#include <memory>
 
namespace HephAudio
{
    enum AudioAPI
    {
        Default,
 
#if defined(_WIN32)
        WASAPI,
        DirectSound,
        MMEAPI,
#endif
 
#if defined(__APPLE__)
        CoreAudio,
#endif
 
#if defined(__ANDROID__)
#if __ANDROID_API__ >= HEPHAUDIO_ANDROID_AAUDIO_MIN_API_LEVEL
        AAudio,
#endif
        OpenSLES,
#endif
 
#if defined(__linux__) && !defined(__ANDROID__)
        ALSA,
#endif
    };
 
    class HEPH_API Audio final
    {
    private:
        std::shared_ptr<Native::NativeAudio> pNativeAudio;
 
    public:
        Heph::Event& OnAudioDeviceAdded;
 
        Heph::Event& OnAudioDeviceRemoved;
 
        Heph::Event& OnCapture;
 
    public:
        Audio();
 
        Audio(AudioAPI api);
 
        std::shared_ptr<Native::NativeAudio> GetNativeAudio() const;
 
        std::shared_ptr<IAudioDecoder> GetAudioDecoder() const;
 
        void SetAudioDecoder(std::shared_ptr<IAudioDecoder> pNewDecoder);
 
        std::shared_ptr<IAudioEncoder> GetAudioEncoder() const;
 
        void SetAudioEncoder(std::shared_ptr<IAudioEncoder> pNewEncoder);
 
        AudioObject* Play(const std::filesystem::path& filePath);
 
        AudioObject* Play(const std::filesystem::path& filePath, uint32_t playCount);
 
        AudioObject* Load(const std::filesystem::path& filePath);
 
        AudioObject* Load(const std::filesystem::path& filePath, uint32_t playCount);
 
        AudioObject* CreateAudioObject(const std::string& name, size_t bufferFrameCount, AudioChannelLayout channelLayout, uint32_t sampleRate);
 
        bool DestroyAudioObject(AudioObject* pAudioObject);
 
        bool DestroyAudioObject(const Heph::Guid& audioObjectId);
 
        bool AudioObjectExists(AudioObject* pAudioObject) const;
 
        bool AudioObjectExists(const Heph::Guid& audioObjectId) const;
 
        AudioObject* GetAudioObject(size_t index) const;
 
        AudioObject* GetAudioObject(const Heph::Guid& audioObjectId);
 
        AudioObject* GetAudioObject(const std::string& audioObjectName) const;
 
        size_t GetAudioObjectCount() const;
 
        void ResumeCapture();
 
        void PauseCapture();
 
        bool IsCapturePaused() const;
 
        uint32_t GetDeviceEnumerationPeriod() const;
 
        void SetDeviceEnumerationPeriod(uint32_t deviceEnumerationPeriod_ms);
 
        void SetMasterVolume(double volume);
 
        double GetMasterVolume() const;
 
        const AudioFormatInfo& GetRenderFormat() const;
 
        const AudioFormatInfo& GetCaptureFormat() const;
 
        void InitializeRender();
 
        void InitializeRender(const AudioChannelLayout& channelLayout, uint32_t sampleRate);
 
        void InitializeRender(AudioFormatInfo format);
 
        void InitializeRender(AudioDevice* device, const AudioChannelLayout& channelLayout, uint32_t sampleRate);
 
        void InitializeRender(AudioDevice* device, AudioFormatInfo format);
 
        void StopRendering();
 
        void InitializeCapture();
 
        void InitializeCapture(const AudioChannelLayout& channelLayout, uint32_t sampleRate);
 
        void InitializeCapture(AudioFormatInfo format);
 
        void InitializeCapture(AudioDevice* device, const AudioChannelLayout& channelLayout, uint32_t sampleRate);
 
        void InitializeCapture(AudioDevice* device, AudioFormatInfo format);
 
        void StopCapturing();
 
        void GetNativeParams(Native::NativeAudioParams& nativeParams) const;
 
        void SetNativeParams(const Native::NativeAudioParams& nativeParams);
 
        AudioDevice GetAudioDeviceById(const std::string& deviceId) const;
 
        AudioDevice GetRenderDevice() const;
 
        AudioDevice GetCaptureDevice() const;
 
        AudioDevice GetDefaultAudioDevice(AudioDeviceType deviceType) const;
 
        std::vector<AudioDevice> GetAudioDevices(AudioDeviceType deviceType) const;
 
    private:
        static std::shared_ptr<Native::NativeAudio> CreateNativeAudio(AudioAPI api);
    };
}