nertc_engine.h

浏览该文件的文档.

 
#ifndef NERTC_ENGINE_H
#define NERTC_ENGINE_H
 
#include "nertc_base.h"
#include "nertc_base_types.h"
#include "nertc_engine_defines.h"
#include "nertc_engine_event_handler_ex.h"
#include "nertc_version.h"
 
namespace nertc {
struct NERtcEngineContext {
    const char* version;
    const char* app_key;
    IRtcEngineEventHandlerEx* event_handler;
    const char* log_dir_path;
    NERtcLogLevel log_level;
    uint32_t log_file_max_size_KBytes;
    bool video_prefer_hw_encoder;
    bool video_prefer_hw_decoder;
    bool video_use_exnternal_render;
    NERtcServerAddresses server_config;
    int32_t area_code_type;
    NERtcIPAddrMode ip_addr_mode;
    NERtcEngineContext() {
        version = NERTC_VERSION;
        app_key = nullptr;
        event_handler = nullptr;
        log_dir_path = nullptr;
        log_level = kNERtcLogLevelWarning;
        log_file_max_size_KBytes = 0;
        video_prefer_hw_encoder = true;
        video_prefer_hw_decoder = true;
        video_use_exnternal_render = false;
        area_code_type = 0;//kNERtcAreaCodeTypeDefault;
        ip_addr_mode = kNERtcIPAddrV4AndV6;
    }
};
 
class IRtcEngine {
public:
    virtual ~IRtcEngine() {}
 
    virtual int initialize(const NERtcEngineContext& context) = 0;
 
    virtual void release(bool sync = true) = 0;
 
    virtual int setClientRole(NERtcClientRole role) = 0;
 
    virtual int setChannelProfile(NERtcChannelProfileType profile) = 0;
 
    virtual int joinChannel(const char* token, const char* channel_name, uid_t uid) = 0;
 
    virtual int joinChannel(const char* token, const char* channel_name, uid_t uid,
                            NERtcJoinChannelOptions channel_options) = 0;
 
    virtual int switchChannel(const char* token, const char* channel_name) = 0;
 
    virtual int switchChannel(const char* token, const char* channel_name, NERtcJoinChannelOptions channel_options) = 0;
 
    virtual int switchChannelEx(const char* token, const char* channel_name, NERtcJoinChannelOptionsEx channel_options_ex) = 0;  
 
    virtual int leaveChannel() = 0;
 
    virtual int queryInterface(NERtcInterfaceIdType iid, void** inter) = 0;
 
    virtual int enableLocalAudio(bool enabled) = 0;
 
    virtual int setupLocalVideoCanvas(NERtcVideoCanvas* canvas) = 0;
 
    virtual int setupRemoteVideoCanvas(uid_t uid, NERtcVideoCanvas* canvas) = 0;
 
    virtual int enableLocalVideo(bool enabled) = 0;
 
    virtual int enableLocalVideo(NERtcVideoStreamType type, bool enabled) = 0;
 
    virtual int subscribeRemoteVideoStream(uid_t uid, NERtcRemoteVideoStreamType type, bool subscribe) = 0;
    virtual int subscribeRemoteVideoStream(uid_t uid, NERtcVideoStreamType stream_type, NERtcRemoteVideoStreamType subscribe_type, bool subscribe) = 0;
};
 
} // namespace nertc
 
 
 
NERTC_API nertc::IRtcEngine* NERTC_CALL createNERtcEngine();
 
NERTC_API void NERTC_CALL destroyNERtcEngine(void*& nertc_engine_inst);
 
 
 
#endif