sound4.x1.cloud.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#ifdef __unix__
    #include <sys/types.h>
    #define CLOUDX1_DECL        __attribute__ ((visibility ("default")))
#elif defined(_WIN32) || defined(WIN32)
    typedef unsigned int uint;
    #ifdef BUILDING_CLOUDX1_DLL
        #define CLOUDX1_DECL    __declspec(dllexport)
    #else
        #define CLOUDX1_DECL    __declspec(dllimport)
    #endif
#endif
 
#ifdef __cplusplus
extern "C" {
#endif // __cplusplus
 
// --------------------------------------------------------------
// --------------------------------------------------------------
// --------------------------------------------------------------
 
// --------------------------------------------------------------
#define CLOUDX1_AUDIOFRAME_COUNT      64
#define CLOUDX1_CHANNEL_COUNT          2
#define CLOUDX1_AUDIO_INPUT_COUNT      1
#define CLOUDX1_AUDIO_OUTPUT_COUNT     1
#define CLOUDX1_SAMPLE_RATE            48000
 
CLOUDX1_DECL const char *cloudx1_GetVersion();
 
CLOUDX1_DECL uint cloudx1_GetChunkSizeInFrames();
 
CLOUDX1_DECL uint cloudx1_GetChannelCount();
 
CLOUDX1_DECL uint cloudx1_GetAudioInputCount();
 
CLOUDX1_DECL uint cloudx1_GetAudioOutputCount();
 
CLOUDX1_DECL uint cloudx1_GetSampleRate();
 
enum cloudx1_LogSeverity {
    none = 0,
    fatal = 1,
    error = 2,
    warning = 3,
    info = 4,
    verbose = 5,
    verbose2 = 6,
    verbose3 = 7,
    verbose4 = 8,
    verbose5 = 9,
};
 
typedef void (*cloudx1_loggerfn) (enum cloudx1_LogSeverity, const char *);
 
CLOUDX1_DECL void cloudx1_SetLoggerCallback( cloudx1_loggerfn logger );
 
CLOUDX1_DECL void cloudx1_SetLogSeverity( enum cloudx1_LogSeverity severity );
 
// --------------------------------------------------------------
// --------------------------------------------------------------
struct cloudx1_CInstance;
 
struct cloudx1_CParameters;
 
CLOUDX1_DECL struct cloudx1_CParameters *cloudx1_NewParameters();
 
CLOUDX1_DECL void cloudx1_FreeParameters(struct cloudx1_CParameters *params);
 
CLOUDX1_DECL void cloudx1_SetParameter(struct cloudx1_CParameters *params, const char *name, const char *value);
 
CLOUDX1_DECL const char *cloudx1_GetParameter(struct cloudx1_CParameters *params, const char *name);
 
CLOUDX1_DECL void cloudx1_FreeParameterValue(const char *value);
 
 
CLOUDX1_DECL struct cloudx1_CInstance *cloudx1_InitProcess(
        const char *LoginKey,
        const char *RadioName,
        const char *AWS_Access_ID,
        const char *AWS_Access_Secret,
        const char *save_path
    );
 
CLOUDX1_DECL struct cloudx1_CInstance *cloudx1_InitProcess2(
        const char *LoginKey,
        const char *RadioName,
        const char *AWS_Access_ID,
        const char *AWS_Access_Secret,
        const char *save_path,
        const struct cloudx1_CParameters *parameters
    );
 
CLOUDX1_DECL void cloudx1_ExitProcess(struct cloudx1_CInstance *instance);
 
// --------------------------------------------------------------
// --------------------------------------------------------------
 
CLOUDX1_DECL void cloudx1_StartUpdateThread(struct cloudx1_CInstance *instance, uint port);
 
CLOUDX1_DECL void cloudx1_StopUpdateThread(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL int cloudx1_WaitUpdateThreadReady(struct cloudx1_CInstance *instance, int milliseconds);
 
// --------------------------------------------------------------
// --------------------------------------------------------------
CLOUDX1_DECL void cloudx1_ProcessAudio(struct cloudx1_CInstance *instance, const float *input, float *output );
 
CLOUDX1_DECL void cloudx1_ProcessAudio_Planar(struct cloudx1_CInstance *instance
    , float const * const (&input)[CLOUDX1_CHANNEL_COUNT*CLOUDX1_AUDIO_INPUT_COUNT]
    , float * const (&output)[CLOUDX1_CHANNEL_COUNT*CLOUDX1_AUDIO_OUTPUT_COUNT]);
 
CLOUDX1_DECL float *cloudx1_GetBufferIn(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL float *cloudx1_GetBufferOut(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL uint cloudx1_GetEstimatedDelay(struct cloudx1_CInstance *instance);
 
// --------------------------------------------------------------
// --------------------------------------------------------------
    #ifdef _MSC_VER
        #define __BYTE_ORDER__  REG_DWORD
        #define __ORDER_LITTLE_ENDIAN__ REG_DWORD_LITTLE_ENDIAN
        #define __ORDER_BIG_ENDIAN__    REG_DWORD_BIG_ENDIAN
    #endif
 
enum cloudx1_SampleFormat {
    INVALID_FORMAT=0,       
    S16_LE,                 
    S16_BE,                 
    S24_LE,                 
    S24_BE,                 
    S32_LE,                 
    S32_BE,                 
    F32_LE,                 
    F32_BE,                 
 
    // Native definitions, only links to the physical ones
    #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
        S16_NATIVE=S16_LE,  
        S24_NATIVE=S24_LE,  
        S32_NATIVE=S32_LE,  
        F32_NATIVE=F32_LE,  
    #else
        S16_NATIVE=S16_BE,  
        S24_NATIVE=S24_BE,  
        S32_NATIVE=S32_BE,  
        F32_NATIVE=F32_BE,  
    #endif
};
 
CLOUDX1_DECL const char *cloudx1_GetFormatName(const enum cloudx1_SampleFormat fmt);
 
CLOUDX1_DECL enum cloudx1_SampleFormat cloudx1_GetFormatFromName(const char *name);
 
CLOUDX1_DECL uint cloudx1_GetBytesFromFormat(const enum cloudx1_SampleFormat fmt);
 
 
CLOUDX1_DECL uint cloudx1_GetMaxPacketFrame(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL uint cloudx1_AddAudio(struct cloudx1_CInstance *instance, const uint8_t *payload, uint nFrame, enum cloudx1_SampleFormat fmt );
 
CLOUDX1_DECL uint cloudx1_AddPadAudio(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL uint cloudx1_GetOutputCount(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL uint cloudx1_GetAudio(struct cloudx1_CInstance *instance, uint8_t *payload, uint max_nFrame, enum cloudx1_SampleFormat fmt );
 
// --------------------------------------------------------------
// --------------------------------------------------------------
struct cloudx1_CClientInstance;
 
CLOUDX1_DECL struct cloudx1_CClientInstance *cloudx1_NewClient(struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL void cloudx1_DeleteClient(struct cloudx1_CClientInstance *client);
 
CLOUDX1_DECL const char *cloudx1_ProcessJson(struct cloudx1_CClientInstance *client, const char *json_str, int *need_save);
 
CLOUDX1_DECL void cloudx1_FreeJsonAnswer(const char *json_str);
 
CLOUDX1_DECL int cloudx1_SaveState(struct cloudx1_CInstance *instance);
 
// --------------------------------------------------------------
// --------------------------------------------------------------
CLOUDX1_DECL uint64_t cloudx1_Webserver_tcp(uint listenport, uint listenport_secure, const char *socket_ip, uint socket_port);
 
// --------------------------------------------------------------
CLOUDX1_DECL uint64_t cloudx1_Webserver_tcp2(uint listenport, uint listenport_secure, const char *socket_ip, uint socket_port, const struct cloudx1_CParameters *parameters);
 
CLOUDX1_DECL uint64_t cloudx1_Webserver(uint listenport, uint listenport_secure, struct cloudx1_CInstance *instance);
 
CLOUDX1_DECL int cloudx1_Webserver_Stop(uint64_t id, int timeout_ms);
 
CLOUDX1_DECL int cloudx1_Webserver_Status(uint64_t id);
 
#define SOUND4_INVALID_WEBSERVER_ID            ((uint64_t)-1)
 
#define SOUND4_WEBSERVER_HTTP_OK               (1<<0)
#define SOUND4_WEBSERVER_HTTPS_OK              (1<<1)
 
#ifdef __cplusplus
} // extern "C"
#endif // __cplusplus