sound4.bigvoice.cl_dyn.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>
 
#if defined(__unix__) || defined(__APPLE__)
    #define UNIXLIKE 1
#else
    #define UNIXLIKE 0
#endif
 
#if UNIXLIKE
    #include <dlfcn.h>
#elif defined(_WIN32)
    #include <libloaderapi.h>
#else
    #error "Unsupported OS"
#endif
 
// Needed to have function declarations
#include "sound4.bigvoice.cl.h"
 
 
#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 *bigvoice_custom_reader(const fs_char *filename, void* userdata);
    static void bigvoice_custom_reader_free(char *content, void* userdata);
    static int bigvoice_custom_writer(const fs_char *filename, const char *content, void* userdata);
    static int bigvoice_custom_exists(const fs_char *filename, void* userdata);
    static fs_char** bigvoice_custom_getall(void* userdata);
    static void bigvoice_custom_getall_free(fs_char** all, void* userdata);
    static int bigvoice_custom_remove(const fs_char *filename, void* userdata);
    static int bigvoice_custom_rename(const fs_char *from, const fs_char *to, void* userdata);
};
 
namespace sound4 {
namespace bigvoice {
namespace dyn {
 
    namespace helper {
 
            template <typename T>
        class DynFuncHolder {
            // Storage definition, depending on OS
            #if UNIXLIKE
                using DynFunc_t = void *; 
            #else
                using DynFunc_t = FARPROC;
            #endif
        private:
            DynFunc_t m_ptr = NULL;
        public:
            DynFuncHolder() = default;
            DynFuncHolder(DynFunc_t a_ptr) : m_ptr(a_ptr) {}
            operator bool() const { return (m_ptr!=NULL); }
            bool IsOk() const { return m_ptr!=NULL; }
            operator T* () const { return reinterpret_cast<T*>(m_ptr); }
        };
 
        class CDynLoader {
            // Storage definition, depending on OS
            #if UNIXLIKE
                using DynLib_t = void *;  
            #else
                using DynLib_t = HMODULE; 
            #endif
            private:
                DynLib_t m_lib {};
            public:
                CDynLoader() = default;
                CDynLoader(CDynLoader&&) = default;
                // No copy allowed
                CDynLoader(const CDynLoader&) = delete;
                CDynLoader& operator=(CDynLoader const&) = delete;
                operator bool() const {
                    return (m_lib!=NULL);
                }
                bool IsOk() const {
                    return (m_lib!=NULL);
                }
                #if UNIXLIKE
                    void Close() {
                        if (IsOk()) {
                            #ifndef __SANITIZE_ADDRESS__ // avoid unloading to keep call stack
                            dlclose(m_lib);
                            #endif // __SANITIZE_ADDRESS__
                            m_lib=NULL;
                        }
                    }
                    bool Load(const std::filesystem::path& dynlib)
                    {
                        Close();
                        m_lib=dlopen(dynlib.c_str(), RTLD_NOW|RTLD_LOCAL);
                        return IsOk();
                    }
                        template <typename T>
                    DynFuncHolder<T> GetSymbol(const std::string& name) {
                        auto ptr=dlsym(m_lib, name.c_str());
                        if (!ptr) {
                            throw std::runtime_error("Missing function in library");
                        }
                        return DynFuncHolder<T>(ptr);
                    }
                        template <typename T>
                    DynFuncHolder<T> GetSymbol_safe(const std::string& name) {
                        auto ptr=dlsym(m_lib, name.c_str());
                        return DynFuncHolder<T>(ptr);
                    }
                    static std::filesystem::path GetThisLibraryPath(void) {
                        static Dl_info info;
                        if (! dladdr((void *) GetThisLibraryPath, & info)) return {};
                        auto rp=realpath(info.dli_fname, NULL);
                        if (!rp) {
                            #if defined(__unix__)
                                rp=realpath("/proc/self/exe", NULL);
                            #elif defined(__APPLE__)
                                // How to solve this for Apple ?
                            #endif
                        }
                        std::filesystem::path p(rp);
                        free(rp);
                        return p;
                    }
                #else
                    bool Load(const std::filesystem::path& dynlib, uint32_t loadflags = LOAD_LIBRARY_SEARCH_DLL_LOAD_DIR|LOAD_LIBRARY_SEARCH_APPLICATION_DIR|LOAD_LIBRARY_SEARCH_USER_DIRS|LOAD_LIBRARY_SEARCH_SYSTEM32)
                    {
                        Close();
                        m_lib=LoadLibraryExW(dynlib.c_str(), NULL, loadflags);
                        return IsOk();
                    }
                    void Close() {
                        if (IsOk()) {
                            // NOTE: On Windows, FreeLibrary may create a lot of troubles, should use FreeLibraryAndExitThread but...
                            // So define SOUND4_CALL_FREELIBRARY before including this file if you really want to unload the library dynamically
                            #if defined(SOUND4_CALL_FREELIBRARYANDEXITTHREAD)
                                FreeLibraryAndExitThread(m_lib, 0);
                            #elif defined(SOUND4_CALL_FREELIBRARY)
                                FreeLibrary(m_lib);
                            #endif // SOUND4_CALL_FREELIBRARY
                            m_lib=NULL;
                        }
                    }
                        template <typename T>
                    DynFuncHolder<T> GetSymbol(const std::string& name) {
                        auto ptr=GetProcAddress(m_lib, name.c_str());
                        if (!ptr) {
                            throw std::runtime_error("Missing function in library");
                        }
                        return DynFuncHolder<T>(ptr);
                    }
                        template <typename T>
                    DynFuncHolder<T> GetSymbol_safe(const std::string& name) {
                        auto ptr=GetProcAddress(m_lib, name.c_str());
                        return DynFuncHolder<T>(ptr);
                    }
                    static std::filesystem::path GetThisLibraryPath(void) {
                        static wchar_t path[MAX_PATH]={};
                        HMODULE hm = NULL;
                        if (GetModuleHandleExW(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS | 
                                GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT,
                                (LPCWSTR) &GetThisLibraryPath, &hm)) 
                        {
                            if (GetModuleFileNameW(hm, path, MAX_PATH) > 0) {
                                return std::filesystem::path(path);
                            }
                        }
                        return {};
                    }
                #endif
                virtual ~CDynLoader() {
                    Close();
                }
        }; // class CDynLoader
    }; // namespace helper
 
    class CDynLib {
    private:
        helper::CDynLoader m_lib;
        bool m_bOK = false;
    public:
        CDynLib() = default;
 
        // All those wrapped functions have the same signature as there C bigvoice_XXX
        helper::DynFuncHolder< decltype(bigvoice_GetVersion             ) > GetVersion             ;
        helper::DynFuncHolder< decltype(bigvoice_GetChunkSizeInFrames   ) > GetChunkSizeInFrames   ;
        helper::DynFuncHolder< decltype(bigvoice_GetChannelCount        ) > GetChannelCount        ;
        helper::DynFuncHolder< decltype(bigvoice_GetAudioInputCount     ) > GetAudioInputCount     ;
        helper::DynFuncHolder< decltype(bigvoice_GetAudioOutputCount    ) > GetAudioOutputCount    ;
        helper::DynFuncHolder< decltype(bigvoice_GetSampleRate          ) > GetSampleRate          ;
        helper::DynFuncHolder< decltype(bigvoice_SetLoggerCallback      ) > SetLoggerCallback      ;
        helper::DynFuncHolder< decltype(bigvoice_SetLogSeverity         ) > SetLogSeverity         ;
        helper::DynFuncHolder< decltype(bigvoice_NewParameters          ) > NewParameters          ;
        helper::DynFuncHolder< decltype(bigvoice_FreeParameters         ) > FreeParameters         ;
        helper::DynFuncHolder< decltype(bigvoice_SetParameter           ) > SetParameter           ;
        helper::DynFuncHolder< decltype(bigvoice_GetParameter           ) > GetParameter           ;
        helper::DynFuncHolder< decltype(bigvoice_FreeParameterValue     ) > FreeParameterValue     ;
        helper::DynFuncHolder< decltype(bigvoice_InitProcess            ) > InitProcess            ;
        helper::DynFuncHolder< decltype(bigvoice_InitProcess2           ) > InitProcess2           ;
        helper::DynFuncHolder< decltype(bigvoice_TerminateProcess       ) > TerminateProcess       ;
        helper::DynFuncHolder< decltype(bigvoice_ExitProcess            ) > ExitProcess            ;
        helper::DynFuncHolder< decltype(bigvoice_StartUpdateThread      ) > StartUpdateThread      ;
        helper::DynFuncHolder< decltype(bigvoice_StopUpdateThread       ) > StopUpdateThread       ;
        helper::DynFuncHolder< decltype(bigvoice_WaitUpdateThreadReady  ) > WaitUpdateThreadReady  ;
        helper::DynFuncHolder< decltype(bigvoice_ProcessAudio           ) > ProcessAudio           ;
        helper::DynFuncHolder< decltype(bigvoice_ProcessAudio_Planar    ) > ProcessAudio_Planar    ;
        helper::DynFuncHolder< decltype(bigvoice_GetBufferIn            ) > GetBufferIn            ;
        helper::DynFuncHolder< decltype(bigvoice_GetBufferOut           ) > GetBufferOut           ;
        helper::DynFuncHolder< decltype(bigvoice_GetEstimatedDelay      ) > GetEstimatedDelay      ;
        helper::DynFuncHolder< decltype(bigvoice_GetFormatName          ) > GetFormatName          ;
        helper::DynFuncHolder< decltype(bigvoice_GetFormatFromName      ) > GetFormatFromName      ;
        helper::DynFuncHolder< decltype(bigvoice_GetBytesFromFormat     ) > GetBytesFromFormat     ;
        helper::DynFuncHolder< decltype(bigvoice_GetMaxPacketFrame      ) > GetMaxPacketFrame      ;
        helper::DynFuncHolder< decltype(bigvoice_AddAudio               ) > AddAudio               ;
        helper::DynFuncHolder< decltype(bigvoice_AddPadAudio            ) > AddPadAudio            ;
        helper::DynFuncHolder< decltype(bigvoice_GetOutputCount         ) > GetOutputCount         ;
        helper::DynFuncHolder< decltype(bigvoice_GetAudio               ) > GetAudio               ;
        helper::DynFuncHolder< decltype(bigvoice_AudioConvertFrom       ) > AudioConvertFrom       ;
        helper::DynFuncHolder< decltype(bigvoice_AudioConvertTo         ) > AudioConvertTo         ;
        helper::DynFuncHolder< decltype(bigvoice_StereoToMono           ) > StereoToMono           ;
        helper::DynFuncHolder< decltype(bigvoice_MonoToStereo           ) > MonoToStereo           ;
        helper::DynFuncHolder< decltype(bigvoice_AudioMonoFromLiveStereo) > AudioMonoFromLiveStereo;
        helper::DynFuncHolder< decltype(bigvoice_AudioMonoToLiveStereo  ) > AudioMonoToLiveStereo  ;
        helper::DynFuncHolder< decltype(bigvoice_NewClient              ) > NewClient              ;
        helper::DynFuncHolder< decltype(bigvoice_DeleteClient           ) > DeleteClient           ;
        helper::DynFuncHolder< decltype(bigvoice_ProcessJson            ) > ProcessJson            ;
        helper::DynFuncHolder< decltype(bigvoice_FreeJsonAnswer         ) > FreeJsonAnswer         ;
        helper::DynFuncHolder< decltype(bigvoice_SaveState              ) > SaveState              ;
#if BIGVOICE_HAS_WEBSERVER
        helper::DynFuncHolder< decltype(bigvoice_Webserver_tcp          ) > Webserver_tcp          ;
        helper::DynFuncHolder< decltype(bigvoice_Webserver_tcp2         ) > Webserver_tcp2         ;
        helper::DynFuncHolder< decltype(bigvoice_Webserver              ) > Webserver              ;
        helper::DynFuncHolder< decltype(bigvoice_Webserver_Stop         ) > Webserver_Stop         ;
        helper::DynFuncHolder< decltype(bigvoice_Webserver_Status       ) > Webserver_Status       ;
#endif // BIGVOICE_HAS_WEBSERVER
 
        // added 2023-03-22
        helper::DynFuncHolder< decltype(bigvoice_StereoToMono_Planar    ) > StereoToMono_Planar    ;
        helper::DynFuncHolder< decltype(bigvoice_MonoToStereo_Planar    ) > MonoToStereo_Planar    ;
 
        // added 2023-05-22
        helper::DynFuncHolder< decltype(bigvoice_SetMetadata            ) > SetMetadata            ;
        helper::DynFuncHolder< decltype(bigvoice_GetMetadataInfos       ) > GetMetadataInfos       ;
        helper::DynFuncHolder< decltype(bigvoice_FreeMetadataInfos      ) > FreeMetadataInfos      ;
 
        // added 2023-06-20
        helper::DynFuncHolder< decltype(bigvoice_SetPresetManager                ) > SetPresetManager      ;
        helper::DynFuncHolder< decltype(bigvoice_PresetManager_InformChange      ) > PresetManager_InformChange      ;
 
        // added 2023-09-21
        helper::DynFuncHolder< decltype(bigvoice_GetPossibleChunkSizeInFrames    ) > GetPossibleChunkSizeInFrames   ;
        helper::DynFuncHolder< decltype(bigvoice_GetProcessChunkFrames           ) > GetProcessChunkFrames   ;
        helper::DynFuncHolder< decltype(bigvoice_InitProcess3                    ) > InitProcess3           ;
 
#if BIGVOICE_HAS_CLOUDBUS
        // added 2023-06-26
        helper::DynFuncHolder< decltype(bigvoice_NewBus                 ) > NewBus      ;
        helper::DynFuncHolder< decltype(bigvoice_FreeBus                ) > FreeBus      ;
        helper::DynFuncHolder< decltype(bigvoice_SetInstanceBus         ) > SetInstanceBus      ;
#endif // BIGVOICE_HAS_CLOUDBUS
 
        // added 2024-02-19
        helper::DynFuncHolder< decltype(bigvoice_SetMetadataMulti       ) > SetMetadataMulti         ;
 
#if BIGVOICE_HAS_WEBSERVER
        // added 2024-05-23
        helper::DynFuncHolder< decltype(bigvoice_Webserver_SetAppHealth    ) > Webserver_SetAppHealth       ;
        helper::DynFuncHolder< decltype(bigvoice_Webserver_GetAppHealth    ) > Webserver_GetAppHealth       ;
        helper::DynFuncHolder< decltype(bigvoice_Webserver_FreeString      ) > Webserver_FreeString         ;
#endif // BIGVOICE_HAS_WEBSERVER
 
#ifdef _WIN32
        // added 2025-05-28
        helper::DynFuncHolder< decltype(bigvoice_SetInstanceTracing                ) > SetInstanceTracing                ;
        helper::DynFuncHolder< decltype(bigvoice_SetInstanceTracingProcessActivity ) > SetInstanceTracingProcessActivity ;
#endif // _WIN32
 
        // added 2025-05-28
        helper::DynFuncHolder< decltype(bigvoice_GetAudioConverter      ) > GetAudioConverter      ;
        helper::DynFuncHolder< decltype(bigvoice_FreeAudioConverter     ) > FreeAudioConverter     ;
        helper::DynFuncHolder< decltype(bigvoice_AudioConverter_From    ) > AudioConverter_From    ;
        helper::DynFuncHolder< decltype(bigvoice_AudioConverter_To      ) > AudioConverter_To      ;
 
        bool Load(const std::filesystem::path& path = {}) {
            std::string filename;
            #if defined(__APPLE__)
                filename="libsound4.bigvoice.cl.dylib";
            #elif defined(__unix__)
                filename="libsound4.bigvoice.cl.so";
            #else
                filename="sound4.bigvoice.cl.dll";
            #endif
            m_lib.Close();
            // If a path is given, use it directly and do not try other path
            if (!path.empty() && !m_lib.Load(path / filename)) {
                return false;
            } else if (!m_lib.IsOk()) {
                auto thisdir=helper::CDynLoader::GetThisLibraryPath().parent_path();
                #ifndef _WIN32
                // Linux: if in a bin directory, try ../lib first
                if (!m_lib.IsOk() && thisdir.filename()=="bin") {
                    auto libdir = thisdir.parent_path() / "lib";
                    m_lib.Load(libdir / filename);
                }
                #endif // !_WIN32
                if (!m_lib.IsOk()) {
                    // Search in the same directory this code is in
                    m_lib.Load(thisdir / filename);
                }
                if (!m_lib.IsOk()) {
                    // Try current path
                    std::error_code ec;
                    auto p = std::filesystem::current_path(ec);
                    if (!ec) {
                        m_lib.Load(p / filename);
                    }
                }
                if (!m_lib.IsOk()) {
                    return false;
                }
            }
            // Load all C functions
            try {
                GetVersion              = m_lib.GetSymbol< decltype(bigvoice_GetVersion             ) >("bigvoice_GetVersion"             );
                GetChunkSizeInFrames    = m_lib.GetSymbol< decltype(bigvoice_GetChunkSizeInFrames   ) >("bigvoice_GetChunkSizeInFrames"   );
                GetChannelCount         = m_lib.GetSymbol< decltype(bigvoice_GetChannelCount        ) >("bigvoice_GetChannelCount"        );
                GetAudioInputCount      = m_lib.GetSymbol< decltype(bigvoice_GetAudioInputCount     ) >("bigvoice_GetAudioInputCount"     );
                GetAudioOutputCount     = m_lib.GetSymbol< decltype(bigvoice_GetAudioOutputCount    ) >("bigvoice_GetAudioOutputCount"    );
                GetSampleRate           = m_lib.GetSymbol< decltype(bigvoice_GetSampleRate          ) >("bigvoice_GetSampleRate"          );
                SetLoggerCallback       = m_lib.GetSymbol< decltype(bigvoice_SetLoggerCallback      ) >("bigvoice_SetLoggerCallback"      );
                SetLogSeverity          = m_lib.GetSymbol< decltype(bigvoice_SetLogSeverity         ) >("bigvoice_SetLogSeverity"         );
                NewParameters           = m_lib.GetSymbol< decltype(bigvoice_NewParameters          ) >("bigvoice_NewParameters"          );
                FreeParameters          = m_lib.GetSymbol< decltype(bigvoice_FreeParameters         ) >("bigvoice_FreeParameters"         );
                SetParameter            = m_lib.GetSymbol< decltype(bigvoice_SetParameter           ) >("bigvoice_SetParameter"           );
                GetParameter            = m_lib.GetSymbol< decltype(bigvoice_GetParameter           ) >("bigvoice_GetParameter"           );
                FreeParameterValue      = m_lib.GetSymbol< decltype(bigvoice_FreeParameterValue     ) >("bigvoice_FreeParameterValue"     );
                InitProcess             = m_lib.GetSymbol< decltype(bigvoice_InitProcess            ) >("bigvoice_InitProcess"            );
                InitProcess2            = m_lib.GetSymbol< decltype(bigvoice_InitProcess2           ) >("bigvoice_InitProcess2"           );
                TerminateProcess        = m_lib.GetSymbol< decltype(bigvoice_TerminateProcess       ) >("bigvoice_TerminateProcess"       );
                ExitProcess             = m_lib.GetSymbol< decltype(bigvoice_ExitProcess            ) >("bigvoice_ExitProcess"            );
                StartUpdateThread       = m_lib.GetSymbol< decltype(bigvoice_StartUpdateThread      ) >("bigvoice_StartUpdateThread"      );
                StopUpdateThread        = m_lib.GetSymbol< decltype(bigvoice_StopUpdateThread       ) >("bigvoice_StopUpdateThread"       );
                WaitUpdateThreadReady   = m_lib.GetSymbol< decltype(bigvoice_WaitUpdateThreadReady  ) >("bigvoice_WaitUpdateThreadReady"  );
                ProcessAudio            = m_lib.GetSymbol< decltype(bigvoice_ProcessAudio           ) >("bigvoice_ProcessAudio"           );
                ProcessAudio_Planar     = m_lib.GetSymbol< decltype(bigvoice_ProcessAudio_Planar    ) >("bigvoice_ProcessAudio_Planar"    );
                GetBufferIn             = m_lib.GetSymbol< decltype(bigvoice_GetBufferIn            ) >("bigvoice_GetBufferIn"            );
                GetBufferOut            = m_lib.GetSymbol< decltype(bigvoice_GetBufferOut           ) >("bigvoice_GetBufferOut"           );
                GetEstimatedDelay       = m_lib.GetSymbol< decltype(bigvoice_GetEstimatedDelay      ) >("bigvoice_GetEstimatedDelay"      );
                GetFormatName           = m_lib.GetSymbol< decltype(bigvoice_GetFormatName          ) >("bigvoice_GetFormatName"          );
                GetFormatFromName       = m_lib.GetSymbol< decltype(bigvoice_GetFormatFromName      ) >("bigvoice_GetFormatFromName"      );
                GetBytesFromFormat      = m_lib.GetSymbol< decltype(bigvoice_GetBytesFromFormat     ) >("bigvoice_GetBytesFromFormat"     );
                GetMaxPacketFrame       = m_lib.GetSymbol< decltype(bigvoice_GetMaxPacketFrame      ) >("bigvoice_GetMaxPacketFrame"      );
                AddAudio                = m_lib.GetSymbol< decltype(bigvoice_AddAudio               ) >("bigvoice_AddAudio"               );
                AddPadAudio             = m_lib.GetSymbol< decltype(bigvoice_AddPadAudio            ) >("bigvoice_AddPadAudio"            );
                GetOutputCount          = m_lib.GetSymbol< decltype(bigvoice_GetOutputCount         ) >("bigvoice_GetOutputCount"         );
                GetAudio                = m_lib.GetSymbol< decltype(bigvoice_GetAudio               ) >("bigvoice_GetAudio"               );
                AudioConvertFrom        = m_lib.GetSymbol< decltype(bigvoice_AudioConvertFrom       ) >("bigvoice_AudioConvertFrom"       );
                AudioConvertTo          = m_lib.GetSymbol< decltype(bigvoice_AudioConvertTo         ) >("bigvoice_AudioConvertTo"         );
                StereoToMono            = m_lib.GetSymbol< decltype(bigvoice_StereoToMono           ) >("bigvoice_StereoToMono"           );
                MonoToStereo            = m_lib.GetSymbol< decltype(bigvoice_MonoToStereo           ) >("bigvoice_MonoToStereo"           );
                AudioMonoFromLiveStereo = m_lib.GetSymbol< decltype(bigvoice_AudioMonoFromLiveStereo) >("bigvoice_AudioMonoFromLiveStereo");
                AudioMonoToLiveStereo   = m_lib.GetSymbol< decltype(bigvoice_AudioMonoToLiveStereo  ) >("bigvoice_AudioMonoToLiveStereo"  );
                NewClient               = m_lib.GetSymbol< decltype(bigvoice_NewClient              ) >("bigvoice_NewClient"              );
                DeleteClient            = m_lib.GetSymbol< decltype(bigvoice_DeleteClient           ) >("bigvoice_DeleteClient"           );
                ProcessJson             = m_lib.GetSymbol< decltype(bigvoice_ProcessJson            ) >("bigvoice_ProcessJson"            );
                FreeJsonAnswer          = m_lib.GetSymbol< decltype(bigvoice_FreeJsonAnswer         ) >("bigvoice_FreeJsonAnswer"         );
                SaveState               = m_lib.GetSymbol< decltype(bigvoice_SaveState              ) >("bigvoice_SaveState"              );
#if BIGVOICE_HAS_WEBSERVER
                Webserver_tcp           = m_lib.GetSymbol< decltype(bigvoice_Webserver_tcp          ) >("bigvoice_Webserver_tcp"          );
                Webserver_tcp2          = m_lib.GetSymbol< decltype(bigvoice_Webserver_tcp2         ) >("bigvoice_Webserver_tcp2"         );
                Webserver               = m_lib.GetSymbol< decltype(bigvoice_Webserver              ) >("bigvoice_Webserver"              );
                Webserver_Stop          = m_lib.GetSymbol< decltype(bigvoice_Webserver_Stop         ) >("bigvoice_Webserver_Stop"         );
                Webserver_Status        = m_lib.GetSymbol< decltype(bigvoice_Webserver_Status       ) >("bigvoice_Webserver_Status"       );
#endif // BIGVOICE_HAS_WEBSERVER
 
                // added 2023-03-22
                StereoToMono_Planar     = m_lib.GetSymbol< decltype(bigvoice_StereoToMono_Planar    ) >("bigvoice_StereoToMono_Planar"    );
                MonoToStereo_Planar     = m_lib.GetSymbol< decltype(bigvoice_MonoToStereo_Planar    ) >("bigvoice_MonoToStereo_Planar"    );
 
            } catch (std::runtime_error& ) {
                return false;
            }
            // C functions allowed to be missing
            try {
                // added 2023-05-22
                SetMetadata             = m_lib.GetSymbol< decltype(bigvoice_SetMetadata            ) >("bigvoice_SetMetadata"            );
                GetMetadataInfos        = m_lib.GetSymbol< decltype(bigvoice_GetMetadataInfos       ) >("bigvoice_GetMetadataInfos"       );
                FreeMetadataInfos       = m_lib.GetSymbol< decltype(bigvoice_FreeMetadataInfos      ) >("bigvoice_FreeMetadataInfos"      );
                // added 2023-06-20
                SetPresetManager            = m_lib.GetSymbol< decltype(bigvoice_SetPresetManager               ) >("bigvoice_SetPresetManager"              );
                PresetManager_InformChange  = m_lib.GetSymbol< decltype(bigvoice_PresetManager_InformChange     ) >("bigvoice_PresetManager_InformChange"    );
 
                // added 2023-09-21
                GetPossibleChunkSizeInFrames = m_lib.GetSymbol< decltype(bigvoice_GetPossibleChunkSizeInFrames  ) >("bigvoice_GetPossibleChunkSizeInFrames"  );
                GetProcessChunkFrames        = m_lib.GetSymbol< decltype(bigvoice_GetProcessChunkFrames         ) >("bigvoice_GetProcessChunkFrames"         );
                InitProcess3                 = m_lib.GetSymbol< decltype(bigvoice_InitProcess3                  ) >("bigvoice_InitProcess3"                  );
 
#if BIGVOICE_HAS_CLOUDBUS
                // added 2023-06-26
                NewBus                  = m_lib.GetSymbol< decltype(bigvoice_NewBus                 ) >("bigvoice_NewBus"                 );
                FreeBus                 = m_lib.GetSymbol< decltype(bigvoice_FreeBus                ) >("bigvoice_FreeBus"                );
                SetInstanceBus          = m_lib.GetSymbol< decltype(bigvoice_SetInstanceBus         ) >("bigvoice_SetInstanceBus"         );
#endif // BIGVOICE_HAS_CLOUDBUS
 
                // added 2024-02-19
                SetMetadataMulti        = m_lib.GetSymbol< decltype(bigvoice_SetMetadataMulti       ) >("bigvoice_SetMetadataMulti"       );
 
#if BIGVOICE_HAS_WEBSERVER
                // added 2024-05-23
                Webserver_SetAppHealth      = m_lib.GetSymbol< decltype(bigvoice_Webserver_SetAppHealth      ) >("Webserver_SetAppHealth"     );
                Webserver_GetAppHealth      = m_lib.GetSymbol< decltype(bigvoice_Webserver_GetAppHealth      ) >("Webserver_GetAppHealth"     );
                Webserver_FreeString        = m_lib.GetSymbol< decltype(bigvoice_Webserver_FreeString        ) >("Webserver_FreeString"       );
                #endif // BIGVOICE_HAS_WEBSERVER
                
#ifdef _WIN32
                // added 2025-05-28
                SetInstanceTracing                = m_lib.GetSymbol< decltype(bigvoice_SetInstanceTracing               ) >("SetInstanceTracing"               );
                SetInstanceTracingProcessActivity = m_lib.GetSymbol< decltype(bigvoice_SetInstanceTracingProcessActivity) >("SetInstanceTracingProcessActivity");
#endif // _WIN32
 
                // added 2025-05-28
                GetAudioConverter                 = m_lib.GetSymbol< decltype(bigvoice_GetAudioConverter                ) >("GetAudioConverter"                );
                FreeAudioConverter                = m_lib.GetSymbol< decltype(bigvoice_FreeAudioConverter               ) >("FreeAudioConverter"               );
                AudioConverter_From               = m_lib.GetSymbol< decltype(bigvoice_AudioConverter_From              ) >("AudioConverter_From"              );
                AudioConverter_To                 = m_lib.GetSymbol< decltype(bigvoice_AudioConverter_To                ) >("AudioConverter_To"                );
 
            }  catch (std::runtime_error& ) {
                // Ignored, handler will take care
            }
 
            m_bOK=true;
            return true;
        }
        bool IsOk() const {
            return m_bOK;
        }
 
    };
 
    
 
    static constexpr const char *process_name = "SOUND4 BIGVOICE.CL";
    static constexpr const char *process_shortname = "bigvoice";
    using SampleFormat = bigvoice_SampleFormat;
    const size_t ChunkFrames=BIGVOICE_AUDIOFRAME_COUNT;
    const size_t InputChannels=BIGVOICE_CHANNEL_COUNT*BIGVOICE_AUDIO_INPUT_COUNT;
    const size_t OutputChannels=BIGVOICE_CHANNEL_COUNT*BIGVOICE_AUDIO_OUTPUT_COUNT;
    const size_t InputSampleSize=ChunkFrames*InputChannels;
    const size_t OutputSampleSize=ChunkFrames*OutputChannels;
    const size_t SampleRate=BIGVOICE_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 bigvoice_SampleFormat format = S16_NATIVE;
        };
            template<>
        struct SampleFormat<int32_t> {
            const bigvoice_SampleFormat format = S32_NATIVE;
        };
            template<>
        struct SampleFormat<float> {
            const bigvoice_SampleFormat format = F32_NATIVE;
        };
 
        // --------------------------------------------------------------
        static inline void AudioConvertFrom(CDynLib& dynlib, const uint8_t *payload, float *output, size_t nSpl, bigvoice_SampleFormat fmt) {
            dynlib.AudioConvertFrom(payload, output, nSpl, fmt);
        }
 
        static inline void AudioConvertTo(CDynLib& dynlib, const float *input, uint8_t *payload, size_t nSpl, bigvoice_SampleFormat fmt) {
            dynlib.AudioConvertTo(input, payload, nSpl, fmt);
        }
 
        static inline void StereoToMono(CDynLib& dynlib, const float *input, float *output, size_t nFrame) {
            dynlib.StereoToMono(input, output, nFrame);
        }
 
        static inline void MonoToStereo(CDynLib& dynlib, const float *input, float *output, size_t nFrame) {
            dynlib.MonoToStereo(input, output, nFrame);
        }
 
        static inline void StereoToMono_Planar(CDynLib& dynlib, const float *inputL, const float *inputR, float *output, size_t nFrame) {
            dynlib.StereoToMono_Planar(inputL, inputR, output, nFrame);
        }
 
        static inline void MonoToStereo_Planar(CDynLib& dynlib, const float *input, float *outputL, float *outputR, size_t nFrame) {
            dynlib.MonoToStereo_Planar(input, outputL, outputR, nFrame);
        }
 
        static inline void AudioMonoFromLiveStereo(CDynLib& dynlib, const uint8_t *payload, float *output) {
            dynlib.AudioMonoFromLiveStereo(payload, output);
        }
 
        static inline void AudioMonoToLiveStereo(CDynLib& dynlib, const float *input, uint8_t *payload) {
            dynlib.AudioMonoToLiveStereo(input, payload);
        }
 
    }; // namespace helper
 
    static inline std::string GetVersion(CDynLib& dynlib)
        {
            return std::string(dynlib.GetVersion());
        }
 
    static inline unsigned int GetChunkSizeInFrames(CDynLib& dynlib)
        {
            return dynlib.GetChunkSizeInFrames();
        }
 
    static inline std::vector<unsigned int> GetPossibleChunkSizeInFrames(CDynLib& dynlib)
        {
            std::vector<unsigned int> list;
            if (dynlib.GetPossibleChunkSizeInFrames) {
                for (unsigned int* src=dynlib.GetPossibleChunkSizeInFrames();*src;src++) {
                    list.push_back(*src);
                }
            } else {
                list.push_back(12);
            }
            return list;
        }
 
    static inline unsigned int GetChannelCount(CDynLib& dynlib)
        {
            return dynlib.GetChannelCount();
        }
 
    static inline unsigned int GetAudioInputCount(CDynLib& dynlib)
        {
            return dynlib.GetAudioInputCount();
        }
 
    static inline unsigned int GetAudioOutputCount(CDynLib& dynlib)
        {
            return dynlib.GetAudioOutputCount();
        }
 
    static inline unsigned int GetSampleRate(CDynLib& dynlib)
        {
            return dynlib.GetSampleRate();
        }
 
    static inline void SanityCheck(CDynLib& dynlib, bool a_bCheckFrames = true)
    {
        // Do some sanity checks
        if (dynlib.GetSampleRate()!=BIGVOICE_SAMPLE_RATE) {
            throw std::runtime_error("Bad library sampling rate");
        }
        if (a_bCheckFrames && dynlib.GetChunkSizeInFrames()!=ChunkFrames) {
            throw std::runtime_error("Bad library frame size");
        }
        if (dynlib.GetChannelCount()!=BIGVOICE_CHANNEL_COUNT) {
            throw std::runtime_error("Bad library channel count");
        }
        if (dynlib.GetAudioInputCount()!=BIGVOICE_AUDIO_INPUT_COUNT) {
            throw std::runtime_error("Bad library input count");
        }
        if (dynlib.GetAudioOutputCount()!=BIGVOICE_AUDIO_OUTPUT_COUNT) {
            throw std::runtime_error("Bad library output count");
        }
    }
 
    static inline std::string GetFormatName(CDynLib& dynlib, const SampleFormat fmt)
        {
            return std::string(dynlib.GetFormatName(fmt));
        }
 
    static inline SampleFormat GetFormatFromName(CDynLib& dynlib, const std::string& name)
        {
            return dynlib.GetFormatFromName(name.c_str());
        }
 
    static inline unsigned int GetBytesFromFormat(CDynLib& dynlib, const SampleFormat fmt)
        {
            return dynlib.GetBytesFromFormat(fmt);
        }
 
    using LogSeverity = bigvoice_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(bigvoice_LogSeverity severity, const char *c_msg) {
            _log_cb(severity, std::string(c_msg));
        }
    }
    static inline void SetLogSeverity(CDynLib& dynlib, LogSeverity severity)
        {
            dynlib.SetLogSeverity(severity);
        }
    static inline void SetLoggerCallback(CDynLib& dynlib, log_cb_t cb)
        {
            _log_cb=cb;
            dynlib.SetLoggerCallback(&_log_cb_c);
        }
 
#if BIGVOICE_HAS_CLOUDBUS
    class CBus {
        public:
            CBus(CDynLib& dynlib)
                : m_dynlib(dynlib)
                {
                    if (m_dynlib.NewBus) {
                        m_bus=m_dynlib.NewBus();
                    }
                } 
            ~CBus()
                {
                    if (m_bus && m_dynlib.FreeBus) {
                        m_dynlib.FreeBus(m_bus);
                    }
                    m_bus = nullptr;
                }
            bigvoice_CBus *Get() const { return m_bus; }
        private:
            CDynLib& m_dynlib;
            bigvoice_CBus *m_bus;
    };
#endif // BIGVOICE_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 = bigvoice_PresetChange_Kind;
 
    class CInstance {
    public:
        CInstance(CDynLib& dynlib)
        : m_dynlib(dynlib) 
            {
                params = m_dynlib.NewParameters();
                if (!params) throw std::bad_alloc();
            }
        // non-copyable
        CInstance( const CInstance& ) = delete;
        CInstance& operator=( const CInstance& ) = delete;
        virtual ~CInstance()
            {
                Stop();
                if (params) m_dynlib.FreeParameters(params);
            }
       bool IsOk() const { return instance!=nullptr; }
        void SetParam(const std::string& name, const std::string& value)
            {
                assert(params);
                m_dynlib.SetParameter(params, name.c_str(), value.c_str());
            }
        std::string GetParam(const std::string& name)
            {
                assert(params);
                auto c_value=m_dynlib.GetParameter(params, name.c_str());
                std::string ret(c_value);
                m_dynlib.FreeParameterValue(c_value);
                return ret;
            }
#if BIGVOICE_HAS_CLOUDBUS
            void SetBus(const CBus& bus) {
                assert(params);
                if (m_dynlib.SetInstanceBus) {
                    m_dynlib.SetInstanceBus(params,bus.Get());
                }
            }
#endif // BIGVOICE_HAS_CLOUDBUS
 
        void SetPresetManager(CPresetLoader *preset_manager)
            {
                if (!preset_manager) return;
                if (!m_dynlib.SetPresetManager) return;
                assert(params);
                m_dynlib.SetPresetManager(params,
                    bigvoice_custom_reader,
                    bigvoice_custom_reader_free,
                    bigvoice_custom_writer,
                    bigvoice_custom_exists,
                    bigvoice_custom_getall,
                    bigvoice_custom_getall_free,
                    bigvoice_custom_remove,
                    bigvoice_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=12)
            {
                assert(!instance);
                std::string l_save_path;
                if (!save_path.empty()) {
                    #if (__cplusplus<202002L)
                    l_save_path = save_path.u8string();
                    #else // C++20
                    l_save_path = (const char*)save_path.u8string().c_str();
                    #endif // C++20
                }
                if (m_dynlib.InitProcess3) {
                    instance = m_dynlib.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);
                } else if (frames_per_chunk!=12) {
                    return false;
                } else {
                    instance = m_dynlib.InitProcess2(LoginKey.c_str(), RadioName.c_str(), Access_Key_ID.c_str(), Access_Key_Secret.c_str(), l_save_path.c_str(), params);
                }
                if (!instance) return false;
                if (!init_metadata.empty()) {
                    for (auto&& [key,value]: init_metadata) {
                        m_dynlib.SetMetadata(instance, key.c_str(), value.c_str());
                    }
                    init_metadata.clear();
                }
                update_thread = std::thread([this, json_port](){
                    OnUpdateThreadStart();
                    m_dynlib.StartUpdateThread(instance, json_port);
                    OnUpdateThreadStop();
                });
                int timeout=5000;
                #ifdef DEBUG
                    timeout=60*1000; // For debugger pauses
                #endif
                if (m_dynlib.WaitUpdateThreadReady(instance, timeout)<0) {
                    return false;
                }
                return true;
            }
 
        unsigned int GetChunkFrames() {
            if (instance && m_dynlib.GetProcessChunkFrames) {
                return m_dynlib.GetProcessChunkFrames(instance);
            }
            return 12;
        }
 
        void PresetManager_InformChange(const std::filesystem::path& relative_path, PresetChange_Kind change_kind)
            {
                if (m_dynlib.PresetManager_InformChange) {
                    m_dynlib.PresetManager_InformChange(instance, relative_path.c_str(), (bigvoice_PresetChange_Kind) change_kind);
                }
            }
 
        void SetMetadata(const std::string& key, const char* value)
            {
                if (m_dynlib.SetMetadata) {
                    if (instance) {
                        m_dynlib.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) {
                    if (m_dynlib.SetMetadataMulti) {
                        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;
                        
                        bigvoice_SetMetadataMulti(instance, keyvalue);
 
                        delete[] keyvalue;
                    } else {
                        for (auto&& [key,value]: list) {
                            SetMetadata(key, value);
                        }
                    }
                } 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;
                if (m_dynlib.GetMetadataInfos) {
                    const char** c_values = m_dynlib.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} );
                            }
                        }
                        m_dynlib.FreeMetadataInfos(instance, c_values);
                    }
                }
                return values;
            }
 
        virtual void OnUpdateThreadStart() {}
        virtual void OnUpdateThreadStop() {}
 
#if BIGVOICE_HAS_WEBSERVER
        bool StartWebServer(int http_port, int https_port=0)
            {
                assert(instance);
                assert(webserver==SOUND4_INVALID_WEBSERVER_ID);
                webserver = m_dynlib.Webserver(http_port,https_port,instance);
                if (webserver==SOUND4_INVALID_WEBSERVER_ID) {
                    return false;
                }
                int web_status=m_dynlib.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) {
                    m_dynlib.Webserver_Stop(webserver, timeout_ms);
                    webserver = SOUND4_INVALID_WEBSERVER_ID;
                }
            }
 
        void SetWebServerAppHealth(int httpcode, const std::string& contenttype, const std::string& content)
            {
                assert(instance);
                if (!m_dynlib.Webserver_SetAppHealth) return;
                m_dynlib.Webserver_SetAppHealth(instance, httpcode, contenttype.c_str(), content.c_str());
            }
        void GetWebServerAppHealth(int &httpcode, std::string& contenttype, std::string& content)
            {
                assert(instance);
                if (!m_dynlib.Webserver_GetAppHealth) return;
                char* c_contenttype=nullptr;
                char* c_content=nullptr;
                m_dynlib.Webserver_GetAppHealth(instance, &httpcode, &c_contenttype, &c_content);
                contenttype=c_contenttype;
                content=c_content;
                m_dynlib.Webserver_FreeString(c_contenttype);
                m_dynlib.Webserver_FreeString(c_content);
            }
#endif // BIGVOICE_HAS_WEBSERVER
 
        int Terminate()
            {
                if (!instance) return 0;
                return m_dynlib.TerminateProcess(instance);
            }
 
        void Stop()
            {
                if (!instance) return;
#if BIGVOICE_HAS_WEBSERVER
                StopWebServer();
#endif // BIGVOICE_HAS_WEBSERVER
                if (update_thread.joinable()) {
                    m_dynlib.StopUpdateThread(instance); // this will exit the update thread
                    update_thread.join();
                }
                m_dynlib.ExitProcess(instance);
                instance=nullptr;
            }
 
        unsigned int GetEstimatedDelay()
            {
                assert(instance);
                return m_dynlib.GetEstimatedDelay(instance);
            }
 
        std::array<float,InputSampleSize>& GetBufferIn()
            {
                assert(instance);
                float *buf=m_dynlib.GetBufferIn(instance);
                return reinterpret_cast< std::array<float,InputSampleSize>& >(*buf);
 
            }
        std::array<float,OutputSampleSize>& GetBufferOut()
            {
                assert(instance);
                float *buf= m_dynlib.GetBufferOut(instance);
                return reinterpret_cast< std::array<float,OutputSampleSize>& >(*buf);
            }
        void ProcessAudio()
            {
                assert(instance);
                m_dynlib.ProcessAudio(instance, m_dynlib.GetBufferIn(instance), m_dynlib.GetBufferOut(instance));
            }
        void ProcessAudio_Planar(float const * const *input, float * const *output)
            {
                assert(instance);
                m_dynlib.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 = m_dynlib.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(bigvoice_CInstance* instance, CDynLib& dynlib)
                : m_dynlib(dynlib)
                    {
                        assert(instance);
                        client=m_dynlib.NewClient(instance);
                        if (!client) throw std::bad_alloc();
                    }
                // non-copyable
                CClient( const CInstance& ) = delete;
                CClient& operator=( const CInstance& ) = delete;
                ~CClient()
                    {
                        if (client) {
                            m_dynlib.DeleteClient(client);
                            client=nullptr;
                        }
                    }
                std::string ProcessJson(const std::string &request, bool *NeedSave = nullptr)
                    {
                        assert(client);
                        int need_save=0;
                        const char *canswer = m_dynlib.ProcessJson(client, request.c_str(), &need_save);
                        if (!canswer) return {};
                        std::string answer(canswer);
                        m_dynlib.FreeJsonAnswer (canswer);
                        if (NeedSave) {
                            *NeedSave=(need_save!=0);
                        }
                        return answer;
                    }
            private:
                CDynLib& m_dynlib;
                bigvoice_CClientInstance *client = nullptr;
        };
        std::shared_ptr<CClient> NewClient()
            {
                assert(instance);
                return std::make_shared<CClient>(instance, m_dynlib);
            }
 
        bool SaveState() {
            assert(instance);
            if (m_dynlib.SaveState(instance)!=0) {
                return false;
            }
            return true;
        }
#ifdef _WIN32
        void SetInstanceTracing(TraceLoggingHProvider tracing_provider, GUID activity_guid = {}) {
            if (m_dynlib.SetInstanceTracing) {
                m_dynlib.SetInstanceTracing(params, tracing_provider, activity_guid);
            }
        }
        void SetInstanceTracingProcessActivity(GUID activity_guid) {
            assert(instance);
            if (m_dynlib.SetInstanceTracingProcessActivity) {
                m_dynlib.SetInstanceTracingProcessActivity(instance, activity_guid);
            }
        }          
#endif // _WIN32
    protected:
            template<typename T>
        unsigned int AddAudio(const T* payload, unsigned int nFrame)
            {
                assert(instance);
                return m_dynlib.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 m_dynlib.GetAudio(instance, reinterpret_cast<T*>(payload), max_nFrame, helper::SampleFormat<T>::format);
            }
 
    private:
        CDynLib& m_dynlib;
        bigvoice_CParameters* params = nullptr;
        bigvoice_CInstance* instance = nullptr;
        std::thread update_thread;
        std::vector< std::pair<std::string,std::string> > init_metadata;
#if BIGVOICE_HAS_WEBSERVER
        uint64_t webserver = SOUND4_INVALID_WEBSERVER_ID;
#endif // BIGVOICE_HAS_WEBSERVER
    };
 
    class CAudioConverter {
        public:
            CAudioConverter(CDynLib& dynlib)
                : m_dynlib(dynlib)
                { }
 
            virtual ~CAudioConverter()
                {
                    Delete();
                }
 
            bool Configure(SampleFormat fmt, size_t nFrame, size_t payl_ch, size_t payl_ch_offset, bigvoice_ConverterTargetMode target_mode)
                {
                    Delete();
                    if (m_dynlib.GetAudioConverter) 
                        m_cvt = m_dynlib.GetAudioConverter((bigvoice_SampleFormat)fmt, nFrame, payl_ch, payl_ch_offset, target_mode);
                    return IsOK();
                }
            void Delete()
                {
                    if (m_cvt && m_dynlib.FreeAudioConverter) {
                        m_dynlib.FreeAudioConverter(m_cvt);
                    }
                    m_cvt = nullptr;
                }
            bool IsOK() const { return (m_cvt!=nullptr); }
 
            void ConvertFrom(const uint8_t *payload, float *output)
                { m_dynlib.AudioConverter_From(m_cvt, payload, output); }
 
            void ConvertTo(const float *input, uint8_t *payload)
                { m_dynlib.AudioConverter_To(m_cvt, input, payload); }
 
        private:
            CDynLib& m_dynlib;
            bigvoice_CAudioConverter *m_cvt = nullptr;
    };
 
}; // namespace dyn
}; // namespace bigvoice
}; // namespace sound4
 
// bridge C callbacks to CPresetLoader
extern "C" {
    static char *bigvoice_custom_reader(const fs_char *filename, void* userdata) {
        sound4::bigvoice::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::bigvoice::dyn::CPresetLoader*>(userdata);
        std::string content=preset_loader->Read(filename);
        return strdup(content.c_str());
    }
    static void bigvoice_custom_reader_free(char *content, void* userdata) {
        if (!content) return;
        free(content);
    }
    static int bigvoice_custom_writer(const fs_char *filename, const char *content, void* userdata) {
        sound4::bigvoice::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::bigvoice::dyn::CPresetLoader*>(userdata);
        auto res=preset_loader->Write(filename,content);
        return res?0:-1;
    }
    static int bigvoice_custom_exists(const fs_char *filename, void* userdata) {
        sound4::bigvoice::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::bigvoice::dyn::CPresetLoader*>(userdata);
        auto res=preset_loader->Exists(filename);
        return res?0:-1;
    }
    static fs_char** bigvoice_custom_getall(void* userdata) {
        sound4::bigvoice::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::bigvoice::dyn::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 bigvoice_custom_getall_free(fs_char** all, void* userdata) {
        if (!all) return;
        for (fs_char** one=all;*one;one++) {
            free(*one);
        }
        free(all);
    }
    static int bigvoice_custom_remove(const fs_char *filename, void* userdata) {
        sound4::bigvoice::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::bigvoice::dyn::CPresetLoader*>(userdata);
        auto res=preset_loader->Remove(filename);
        return res?0:-1;
    }
    static int bigvoice_custom_rename(const fs_char *from, const fs_char *to, void* userdata) {
        sound4::bigvoice::dyn::CPresetLoader *preset_loader=reinterpret_cast<sound4::bigvoice::dyn::CPresetLoader*>(userdata);
        auto res=preset_loader->Rename(from,to);
        return res?0:-1;
    }
    
};