tencent cloud

/*
SDK Init will be blocked until the server is connected
*/
int TRRO_initJsonPath(const char* jsonPath); 

/*
SDK Init will be blocked until the server is connected
*/
int TRRO_initJson(const char* json); 

void TRRO_destroy();

//block until the list is retrived from cloud,  it should copy the returned strings as soon as possible.
const char* TRRO_getGwList();


//block until the info is retrived from cloud,  it should copy the returned strings as soon as possible.
const char* TRRO_getGwInfo(const char* gwid);

// async mode to connect the video, the video connection status is notified by onState callback
// can be called with multiple times to connect different field devices
int TRRO_connectField(const char* gwid, int streams_num, int* streams_id, int* conn_fds, int compatible = 0, const char* record_config = NULL);

void TRRO_setWindows(int* conn_fds, WindowIdType * windows, int num);

int TRRO_disconnect(int* conn_fds, int fd_num);

int TRRO_disconnectAll();

int TRRO_SetRenderConfig(int *conn_fds, int *rotation, int *scale, int *config, int num);

int TRRO_fieldDeviceEncodeConfig(const char* gwid, int streams_id, const char* encode_config);

int TRRO_startMediaPush(int conn_fd, const char* path);

int TRRO_stopMediaPush(int conn_fd);

void TRRO_registerRemoteFrameCallback(void* context, TRRO_onRemoteFrameData * callback, int frame_type = 0);
 
typedef void STD_CALL TRRO_onRemoteFrameData(void* context, const char* gwid, int stream_id, int conn_fd, const char* data, int width, int height, long long videotime);

void TRRO_registerRemoteEncodedFrameCallback(void* context, TRRO_onRemoteEncodedFrameData* callback);


typedef void STD_CALL TRRO_onRemoteEncodedFrameData(void* context, const char* gwid, int stream_id, int conn_fd,
                                                    const char* data, int len, TrroCodec trro_codec, bool is_key_frame,
                                                    long long videotime);

 int TRRO_useExternalDecoder(bool external);

 int TRRO_externAudioData(const char* gwid, const char* data, int data_size, int channel, int sample_rate);

int TRRO_audioMute(const char* gwid, bool mute);

int TRRO_sendControlData(const char* gwid, const char* msg, int len, int qos = 0);

void TRRO_registerReportDataCallback(void* context, TRRO_onReportData * callback);

/*
* @name :  TRRO_onReportData
* @brief : Callback for receiving information from field devices
* @input : context     The context pointer for the callback, which returns the context passed when the callback function is registered
*          gwid        The ID of the field device from which the message originates 
*          msg         Message, binary passthrough
*          len         Message length
*          qos         Message transmission QoS source, 0: unreliable transmission, 1: reliable transmission
* @return : void
*/
typedef void STD_CALL TRRO_onReportData(void* context, const char* gwid, const char* msg, int len, int qos);


int TRRO_requestPermission(const char* gwid, int permisson);

void TRRO_registerOnOperationPermissionState(void* context, TRRO_OnOperationPermissionState* callback);

typedef void STD_CALL TRRO_OnOperationPermissionState(void* context, const char* field_devid, int self_permission, const char* master_devid);

void TRRO_registerAllLatencyCallback(void* context, TRRO_onAllLatencyReport * callback);

typedef void STD_CALL TRRO_onAllLatencyReport(void* context, const char* gwid, int conn_fd, long long latency1, long long latency2, long long videotime, int rcct);

int TRRO_registerSignalStateCallback(void *context, TRRO_onSignalState *callback);

enum SignalState {
    kTrroReady = 0, /**< first connection is setup successfully */
    kTrroLost = 1,  /**< connection is lost, but the sdk will try to reconnect */
    kTrroReup = 2,  /**< reconnect successfully */
    kTrroKickout = 3,  /**< the connection is kicked out due to same id login */
    kTrroAuthFailed = 4,  /**< deviceid or password error */
};

typedef void TRRO_onSignalState(void *context, SignalState state);

void TRRO_registerOnState(void* context, TRRO_OnState * callback);

enum TrroState {
    kDisconnect = 0,   /**< video connection is disconnected */
    kConnecting = 1,    /**< begin to setup the video connection */
    kConnected = 2,    /**< video connection is connected successfully */
    kDisconnecting = 3,    /**< begin to disconnect the video connection */
};

typedef void STD_CALL TRRO_OnState(void* context, const char* gwid, int stream_id, int conn_fd, int state);

void TRRO_registerOnMediaStateInfo(void* context, TRRO_OnMediaStateInfo * callback);

struct TrroMediaState {
    int fps;    // video fps
    int bps;    // video bitrate, in unit of bps
    int rtt;    //  network rtt between remote device and server for video transmission
    long long decd;   //video decode time, in unit of ms
    int jitter;   // network rtt jitter, in unit of ms
    long long packets_lost;   // packets loss rate (0-255), loss percent = packets_lost / 255 * 100%
    long long packets_received; // num of received packets
    int stun;  // stun mode of the video connection, 0: host, 1: srflx, 2: prflx, 3: relay
    double lag_k100;  // 100ms video lag rate, equals sum(max(video_frame_interval - 100, 0)) / video_duration
    double lag_k150;  // 150ms video lag rate, equals sum(max(video_frame_interval - 150, 0)) / video_duration
    long long duration;  // duration of video stream, in unit of ms
};

typedef void STD_CALL TRRO_OnMediaStateInfo(void* context, int conn_fd, TrroMediaState mediastate);

void TRRO_registerFieldSideNetworkState(void* context, TRRO_onFieldSideMediaState * callback);

typedef void TRRO_onFieldSideMediaState(void* context, const char* gwid, int stream_id, int fps, int bps, int rtt, int jitter, int lost);