sound4.x1.cloud.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <string>
#include <exception>
#include <thread>
#include <functional>
#include <memory>
#include <array>
#include <assert.h>
#include <stdexcept>
#include <filesystem>
#include <string.h>
 
#include "sound4.x1.cloud.h"
 
 
// Filesystem path char type
#ifdef _WIN32
    #include <stringapiset.h>
    #include <wchar.h>
    #define fs_strdup wcsdup
    #ifdef _MSC_VER
        #pragma warning(disable : 4996)
    #endif
#else // !_WIN32
    #define fs_strdup strdup
#endif // !_WIN32
 
// bridge C callbacks to CPresetLoader
extern "C" {
    static char *cloudx1_custom_reader(const fs_char *filename, void* userdata);
    static void cloudx1_custom_reader_free(char *content, void* userdata);
    static int cloudx1_custom_writer(const fs_char *filename, const char *content, void* userdata);
    static int cloudx1_custom_exists(const fs_char *filename, void* userdata);
    static fs_char** cloudx1_custom_getall(void* userdata);
    static void cloudx1_custom_getall_free(fs_char** all, void* userdata);
    static int cloudx1_custom_remove(const fs_char *filename, void* userdata);
    static int cloudx1_custom_rename(const fs_char *from, const fs_char *to, void* userdata);
};
 
namespace sound4 {
namespace cloudx1 {
    static constexpr const char *process_name = "SOUND4 x1.CLOUD";
    static constexpr const char *process_shortname = "x1";
    using SampleFormat = cloudx1_SampleFormat;
    const size_t ChunkFrames=CLOUDX1_AUDIOFRAME_COUNT;
    const size_t InputChannels=CLOUDX1_CHANNEL_COUNT*CLOUDX1_AUDIO_INPUT_COUNT;
    const size_t OutputChannels=CLOUDX1_CHANNEL_COUNT*CLOUDX1_AUDIO_OUTPUT_COUNT;
    const size_t InputSampleSize=ChunkFrames*InputChannels;
    const size_t OutputSampleSize=ChunkFrames*OutputChannels;
    const size_t SampleRate=CLOUDX1_SAMPLE_RATE;
 
    namespace helper {
        #ifdef _WIN32
        static inline std::string WStringToUTF8(const std::wstring& wstr) {
            if (wstr.empty()) return {};
            int size = WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), NULL, 0, NULL, NULL);
            std::string str(size, 0);
            WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), &str[0], size, NULL, NULL);
            return str;
        }
        static inline std::wstring UTF8ToWString(const std::string& str) {
            if (str.empty()) return std::wstring();
            int size = MultiByteToWideChar(CP_UTF8, 0, &str[0], (int)str.size(), NULL, 0);
            std::wstring wstr(size, 0);
            MultiByteToWideChar(CP_UTF8, 0, &str[0], (int)str.size(), &wstr[0], size);
            return wstr;
        }
        #endif // _WIN32
 
            template<typename T>
        struct SampleFormat {
        };
            template<>
        struct SampleFormat<int16_t> {
            const cloudx1_SampleFormat format = S16_NATIVE;
        };
            template<>
        struct SampleFormat<int32_t> {
            const cloudx1_SampleFormat format = S32_NATIVE;
        };
            template<>
        struct SampleFormat<float> {
            const cloudx1_SampleFormat format = F32_NATIVE;
        };
 
        // --------------------------------------------------------------
        static inline void AudioConvertFrom(const uint8_t *payload, float *output, size_t nSpl, cloudx1_SampleFormat fmt) {
            cloudx1_AudioConvertFrom(payload, output, nSpl, fmt);
        }
 
        static inline void AudioConvertTo(const float *input, uint8_t *payload, size_t nSpl, cloudx1_SampleFormat fmt) {
            cloudx1_AudioConvertTo(input, payload, nSpl, fmt);
        }
 
        static inline void StereoToMono(const float *input, float *output, size_t nFrame) {
            cloudx1_StereoToMono(input, output, nFrame);
        }
 
        static inline void MonoToStereo(const float *input, float *output, size_t nFrame) {
            cloudx1_MonoToStereo(input, output, nFrame);
        }
 
        static inline void StereoToMono_Planar(const float *inputL, const float *inputR, float *output, size_t nFrame) {
            cloudx1_StereoToMono_Planar(inputL, inputR, output, nFrame);
        }
 
        static inline void MonoToStereo_Planar(const float *input, float *outputL, float *outputR, size_t nFrame) {
            cloudx1_MonoToStereo_Planar(input, outputL, outputR, nFrame);
        }
 
        static inline void AudioMonoFromLiveStereo(const uint8_t *payload, float *output) {
            cloudx1_AudioMonoFromLiveStereo(payload, output);
        }
 
        static inline void AudioMonoToLiveStereo(const float *input, uint8_t *payload) {
            cloudx1_AudioMonoToLiveStereo(input, payload);
        }
 
    }; // namespace helper
 
    static inline std::string GetVersion()
        {
            return std::string(cloudx1_GetVersion());
        }
 
    static inline unsigned int GetChunkSizeInFrames()
        {
            return cloudx1_GetChunkSizeInFrames();
        }
 
    static inline std::vector<unsigned int> GetPossibleChunkSizeInFrames()
        {
            std::vector<unsigned int> list;
            for (unsigned int* src=cloudx1_GetPossibleChunkSizeInFrames();*src;src++) {
                list.push_back(*src);
            }
            return list;
        }
 
    static inline unsigned int GetChannelCount()
        {
            return cloudx1_GetChannelCount();
        }
 
    static inline unsigned int GetAudioInputCount()
        {
            return cloudx1_GetAudioInputCount();
        }
 
    static inline unsigned int GetAudioOutputCount()
        {
            return cloudx1_GetAudioOutputCount();
        }
 
    static inline unsigned int GetSampleRate()
        {
            return cloudx1_GetSampleRate();
        }
 
    static inline void SanityCheck(bool a_bCheckFrames = true)
    {
        // Do some sanity checks
        if (cloudx1_GetSampleRate()!=CLOUDX1_SAMPLE_RATE) {
            throw std::runtime_error("Bad library sampling rate");
        }
        if (a_bCheckFrames && cloudx1_GetChunkSizeInFrames()!=ChunkFrames) {
            throw std::runtime_error("Bad library frame size");
        }
        if (cloudx1_GetChannelCount()!=CLOUDX1_CHANNEL_COUNT) {
            throw std::runtime_error("Bad library channel count");
        }
        if (cloudx1_GetAudioInputCount()!=CLOUDX1_AUDIO_INPUT_COUNT) {
            throw std::runtime_error("Bad library input count");
        }
        if (cloudx1_GetAudioOutputCount()!=CLOUDX1_AUDIO_OUTPUT_COUNT) {
            throw std::runtime_error("Bad library output count");
        }
    }
 
    static inline std::string GetFormatName(const SampleFormat fmt)
        {
            return std::string(cloudx1_GetFormatName(fmt));
        }
 
    static inline SampleFormat GetFormatFromName(const std::string& name)
        {
            return cloudx1_GetFormatFromName(name.c_str());
        }
 
    static inline unsigned int GetBytesFromFormat(const SampleFormat fmt)
        {
            return cloudx1_GetBytesFromFormat(fmt);
        }
 
    using LogSeverity = cloudx1_LogSeverity;
    using log_cb_t = std::function<void(LogSeverity,const std::string&)>;
 
    static log_cb_t _log_cb;
    extern "C" {
        static inline void _log_cb_c(cloudx1_LogSeverity severity, const char *c_msg) {
            _log_cb(severity, std::string(c_msg));
        }
    }
    static inline void SetLogSeverity(LogSeverity severity)
        {
            cloudx1_SetLogSeverity(severity);
        }
    static inline void SetLoggerCallback(log_cb_t cb)
        {
            _log_cb=cb;
            cloudx1_SetLoggerCallback(&_log_cb_c);
        }
 
#if CLOUDX1_HAS_CLOUDBUS
    class CBus {
        public:
            CBus()
                : m_bus(cloudx1_NewBus()) {}
            ~CBus()
                {
                    cloudx1_FreeBus(m_bus);
                    m_bus = nullptr;
                }
            cloudx1_CBus *Get() const { return m_bus; }
        private:
            cloudx1_CBus *m_bus;
    };
#endif // CLOUDX1_HAS_CLOUDBUS
 
    class CPresetLoader {
    public:
        CPresetLoader() = default;
        virtual ~CPresetLoader() = default;
 
        virtual bool IsReadOnly() = 0;
        virtual bool Exists(const std::filesystem::path &name) = 0;
        virtual bool Remove(const std::filesystem::path &name) = 0;
        virtual bool Rename(const std::filesystem::path &from, const std::filesystem::path &to) = 0;
        virtual std::vector<std::filesystem::path> GetAll() = 0;
        virtual std::string Read(const std::filesystem::path &filename) = 0;
        virtual bool Write(const std::filesystem::path &filename, const std::string &content) =0;
    };
    using PresetChange_Kind = cloudx1_PresetChange_Kind;
 
    class CInstance {
    public:
        CInstance()
            {
                params = cloudx1_NewParameters();
                if (!params) throw std::bad_alloc();
            }
        // non-copyable
        CInstance( const CInstance& ) = delete;
        CInstance& operator=( const CInstance& ) = delete;
        virtual ~CInstance()
            {
                Stop();
                if (params) cloudx1_FreeParameters(params);
            }
       bool IsOk() const { return instance!=nullptr; }
        void SetParam(const std::string& name, const std::string& value)
            {
                assert(params);
                cloudx1_SetParameter(params, name.c_str(), value.c_str());
            }
        std::string GetParam(const std::string& name)
            {
                assert(params);
                auto c_value=cloudx1_GetParameter(params, name.c_str());
                std::string ret(c_value);
                cloudx1_FreeParameterValue(c_value);
                return ret;
            }
 
#if CLOUDX1_HAS_CLOUDBUS
            void SetBus(const CBus& bus) {
                assert(params);
                cloudx1_SetInstanceBus(params,bus.Get());
            }
#endif // CLOUDX1_HAS_CLOUDBUS
 
        void SetPresetManager(CPresetLoader *preset_manager)
            {
                if (!preset_manager) return;
                assert(params);
                cloudx1_SetPresetManager(params,
                    cloudx1_custom_reader,
                    cloudx1_custom_reader_free,
                    cloudx1_custom_writer,
                    cloudx1_custom_exists,
                    cloudx1_custom_getall,
                    cloudx1_custom_getall_free,
                    cloudx1_custom_remove,
                    cloudx1_custom_rename,
                    preset_manager->IsReadOnly(),
                    preset_manager
                );
            }
 
        bool Create(const std::string& LoginKey, const std::string& RadioName, const std::string& Access_Key_ID, const std::string& Access_Key_Secret, const std::filesystem::path& save_path, int json_port = 0, unsigned int frames_per_chunk=64)
            {
                assert(!instance);
                std::string l_save_path;
                if (!save_path.empty()) {
                    l_save_path = save_path.u8string();
                }
                instance = cloudx1_InitProcess3(LoginKey.c_str(), RadioName.c_str(), Access_Key_ID.c_str(), Access_Key_Secret.c_str(), l_save_path.c_str(), params, frames_per_chunk);
                if (!instance) return false;
                if (!init_metadata.empty()) {
                    for (auto&& [key,value]: init_metadata) {
                        cloudx1_SetMetadata(instance, key.c_str(), value.c_str());
                    }
                    init_metadata.clear();
                }
                update_thread = std::thread([this, json_port](){
                    OnUpdateThreadStart();
                    cloudx1_StartUpdateThread(instance, json_port);
                    OnUpdateThreadStop();
                });
                int timeout=5000;
                #ifdef DEBUG
                    timeout=60*1000; // For debugger pauses
                #endif
                if (cloudx1_WaitUpdateThreadReady(instance, timeout)<0) {
                    return false;
                }
                return true;
            }
 
        unsigned int GetChunkFrames() {
            if (instance) {
                return cloudx1_GetProcessChunkFrames(instance);
            }
            return 0;
        }
 
        void PresetManager_InformChange(const std::filesystem::path& relative_path, PresetChange_Kind change_kind)
            {
                cloudx1_PresetManager_InformChange(instance, relative_path.c_str(), (cloudx1_PresetChange_Kind) change_kind);
            }
 
        void SetMetadata(const std::string& key, const char* value)
            {
                if (instance) {
                    cloudx1_SetMetadata(instance, key.c_str(), value);
                } else {
                    init_metadata.push_back( {key, value} );
                }
            }
 
        void SetMetadataMulti(const std::unordered_map<std::string, const char*>& list)
            {
                if (instance) {
                    typedef const char* pchar;
                    pchar* keyvalue=new pchar[2*list.size()+1];
                    size_t n=0;
                    for (auto&& [key,value]: list) {
                        keyvalue[2*n+0]=key.c_str();
                        keyvalue[2*n+1]=value;
                        n++;
                    }
                    keyvalue[2*n+0]=nullptr;
                    
                    cloudx1_SetMetadataMulti(instance, keyvalue);
 
                    delete[] keyvalue;
                } else {
                    for (auto&& [key,value]: list) {
                        if (value) {
                            init_metadata.push_back( {key, value} );
                        }
                    }
                }
            }
 
        std::vector< std::tuple<std::string,std::string> > GetMetadataInfos()
            {
                std::vector< std::tuple<std::string,std::string> > values;
                const char** c_values = cloudx1_GetMetadataInfos(instance);
                if (c_values) {
                    for (const char** c_value=c_values; *c_value; ) {
                        std::string key(*c_value);
                        c_value++;
                        if (*c_value) {
                            std::string descr(*c_value);
                            c_value++;
                            values.push_back( {key,descr} );
                        }
                    }
                    cloudx1_FreeMetadataInfos(instance, c_values);
                }
                return values;
            }
 
        virtual void OnUpdateThreadStart() {}
        virtual void OnUpdateThreadStop() {}
 
#if CLOUDX1_HAS_WEBSERVER
        bool StartWebServer(int http_port, int https_port=0)
            {
                assert(instance);
                assert(webserver==SOUND4_INVALID_WEBSERVER_ID);
                webserver = cloudx1_Webserver(http_port,https_port,instance);
                if (webserver==SOUND4_INVALID_WEBSERVER_ID) {
                    return false;
                }
                int web_status=cloudx1_Webserver_Status(webserver);
                if (http_port && (web_status & SOUND4_WEBSERVER_HTTP_OK) == 0) {
                    return false;
                }
                if (https_port && (web_status & SOUND4_WEBSERVER_HTTPS_OK) == 0) {
                    return false;
                }
                return true;
            }
 
            void StopWebServer(int timeout_ms = 1000)
            {
                if (webserver != SOUND4_INVALID_WEBSERVER_ID) {
                    cloudx1_Webserver_Stop(webserver, timeout_ms);
                    webserver = SOUND4_INVALID_WEBSERVER_ID;
                }
            }
 
        void SetWebServerAppHealth(int httpcode, const std::string& contenttype, const std::string& content)
            {
                assert(instance);
                cloudx1_Webserver_SetAppHealth(instance, httpcode, contenttype.c_str(), content.c_str());
            }
        void GetWebServerAppHealth(int &httpcode, std::string& contenttype, std::string& content)
            {
                assert(instance);
                char* c_contenttype=nullptr;
                char* c_content=nullptr;
                cloudx1_Webserver_GetAppHealth(instance, &httpcode, &c_contenttype, &c_content);
                contenttype=c_contenttype;
                content=c_content;
                cloudx1_Webserver_FreeString(c_contenttype);
                cloudx1_Webserver_FreeString(c_content);
        }
#endif // CLOUDX1_HAS_WEBSERVER
 
        int Terminate()
            {
                if (!instance) return 0;
                return cloudx1_TerminateProcess(instance);
            }
 
        void Stop()
            {
                if (!instance) return;
#if CLOUDX1_HAS_WEBSERVER
                StopWebServer();
#endif // CLOUDX1_HAS_WEBSERVER
                if (update_thread.joinable()) {
                    cloudx1_StopUpdateThread(instance); // this will exit the update thread
                    update_thread.join();
                }
                cloudx1_ExitProcess(instance);
                instance=nullptr;
            }
 
        unsigned int GetEstimatedDelay()
            {
                assert(instance);
                return cloudx1_GetEstimatedDelay(instance);
            }
 
        std::array<float,InputSampleSize>& GetBufferIn()
            {
                assert(instance);
                float *buf=cloudx1_GetBufferIn(instance);
                return reinterpret_cast< std::array<float,InputSampleSize>& >(*buf);
 
            }
        std::array<float,OutputSampleSize>& GetBufferOut()
            {
                assert(instance);
                float *buf= cloudx1_GetBufferOut(instance);
                return reinterpret_cast< std::array<float,OutputSampleSize>& >(*buf);
            }
        void ProcessAudio()
            {
                assert(instance);
                cloudx1_ProcessAudio(instance, cloudx1_GetBufferIn(instance), cloudx1_GetBufferOut(instance));
            }
        void ProcessAudio_Planar(float const * const *input, float * const *output)
            {
                assert(instance);
                cloudx1_ProcessAudio_Planar(instance, input, output);
            }
 
            template<typename T>
        std::vector<T> ProcessAnyAudio(const std::vector<T> input)
            {
                assert(instance);
                std::vector<T> output;
                unsigned int out_offset=0;
                unsigned int in_offset=0;
                unsigned int todo = input.size();
                while (todo>0) {
                    unsigned int left = AddAudio(&input[in_offset], todo);
                    unsigned int out_avail = cloudx1_GetOutputCount(instance);
                    output.resize(out_offset + out_avail);
                    GetAudio(&output[out_offset], out_avail);
                    out_offset+=out_avail;
                    in_offset += todo-left;
                    todo=left;
                }
                return output;
            }
 
        class CClient {
            public:
                CClient(cloudx1_CInstance* instance)
                    {
                        assert(instance);
                        client=cloudx1_NewClient(instance);
                        if (!client) throw std::bad_alloc();
                    }
                // non-copyable
                CClient( const CInstance& ) = delete;
                CClient& operator=( const CInstance& ) = delete;
                ~CClient()
                    {
                        if (client) {
                            cloudx1_DeleteClient(client);
                            client=nullptr;
                        }
                    }
                std::string ProcessJson(const std::string &request, bool *NeedSave = nullptr)
                    {
                        assert(client);
                        int need_save=0;
                        const char *canswer = cloudx1_ProcessJson(client, request.c_str(), &need_save);
                        if (!canswer) return {};
                        std::string answer(canswer);
                        cloudx1_FreeJsonAnswer (canswer);
                        if (NeedSave) {
                            *NeedSave=(need_save!=0);
                        }
                        return answer;
                    }
            private:
                cloudx1_CClientInstance *client = nullptr;
        };
        std::shared_ptr<CClient> NewClient()
            {
                assert(instance);
                return std::make_shared<CClient>(instance);
            }
 
        bool SaveState() {
            assert(instance);
            if (cloudx1_SaveState(instance)!=0) {
                return false;
            }
            return true;
        }
#ifdef _WIN32
        void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid = {}) {
            cloudx1_SetInstanceTracing(params, tracing_provider, activity_guid);
        }
        void SetInstanceTracingProcessActivity(GUID activity_guid) {
            assert(instance);
            cloudx1_SetInstanceTracingProcessActivity(instance, activity_guid);
        }
#endif // _WIN32
    protected:
            template<typename T>
        unsigned int AddAudio(const T* payload, unsigned int nFrame)
            {
                assert(instance);
                return cloudx1_AddAudio(instance, reinterpret_cast<const T*>(payload), nFrame, helper::SampleFormat<T>::format);
            }
            template<typename T>
        unsigned int GetAudio(T* payload, unsigned int max_nFrame)
            {
                assert(instance);
                return cloudx1_GetAudio(instance, reinterpret_cast<T*>(payload), max_nFrame, helper::SampleFormat<T>::format);
            }
 
    private:
        cloudx1_CParameters* params = nullptr;
        cloudx1_CInstance* instance = nullptr;
        std::thread update_thread;
        std::vector< std::pair<std::string,std::string> > init_metadata;
#if CLOUDX1_HAS_WEBSERVER
        uint64_t webserver = SOUND4_INVALID_WEBSERVER_ID;
#endif // CLOUDX1_HAS_WEBSERVER
    };
 
}; // namespace cloudx1
}; // namespace sound4
 
// bridge C callbacks to CPresetLoader
extern "C" {
    static char *cloudx1_custom_reader(const fs_char *filename, void* userdata) {
        sound4::cloudx1::CPresetLoader *preset_loader=reinterpret_cast<sound4::cloudx1::CPresetLoader*>(userdata);
        std::string content=preset_loader->Read(filename);
        return strdup(content.c_str());
    }
    static void cloudx1_custom_reader_free(char *content, void* userdata) {
        if (!content) return;
        free(content);
    }
    static int cloudx1_custom_writer(const fs_char *filename, const char *content, void* userdata) {
        sound4::cloudx1::CPresetLoader *preset_loader=reinterpret_cast<sound4::cloudx1::CPresetLoader*>(userdata);
        auto res=preset_loader->Write(filename,content);
        return res?0:-1;
    }
    static int cloudx1_custom_exists(const fs_char *filename, void* userdata) {
        sound4::cloudx1::CPresetLoader *preset_loader=reinterpret_cast<sound4::cloudx1::CPresetLoader*>(userdata);
        auto res=preset_loader->Exists(filename);
        return res?0:-1;
    }
    static fs_char** cloudx1_custom_getall(void* userdata) {
        sound4::cloudx1::CPresetLoader *preset_loader=reinterpret_cast<sound4::cloudx1::CPresetLoader*>(userdata);
        auto res=preset_loader->GetAll();
        fs_char**all=(fs_char**)malloc((res.size()+1)*sizeof(const fs_char*));
        for (size_t n=0;n<res.size();n++) {
            all[n]=fs_strdup(res[n].c_str());
        }
        all[res.size()]=nullptr;
        return all;
    }
    static void cloudx1_custom_getall_free(fs_char** all, void* userdata) {
        if (!all) return;
        for (fs_char** one=all;*one;one++) {
            free(*one);
        }
        free(all);
    }
    static int cloudx1_custom_remove(const fs_char *filename, void* userdata) {
        sound4::cloudx1::CPresetLoader *preset_loader=reinterpret_cast<sound4::cloudx1::CPresetLoader*>(userdata);
        auto res=preset_loader->Remove(filename);
        return res?0:-1;
    }
    static int cloudx1_custom_rename(const fs_char *from, const fs_char *to, void* userdata) {
        sound4::cloudx1::CPresetLoader *preset_loader=reinterpret_cast<sound4::cloudx1::CPresetLoader*>(userdata);
        auto res=preset_loader->Rename(from,to);
        return res?0:-1;
    }
    
};