..\..\Release\include

..\..\Release\lib

qiniu::RTCEngineInterface::Obtain()->InitEngine();

qiniu::RTCEngineInterface::Obtain()->SetSdkLog(qiniu::LOG_NORMAL, "RTCLog", "log");

qiniu::RTCRoomInterface* _rtc_room_interface = qiniu::RTCRoomInterface::Create(room_id_);

//其它用户进入房间通知
virtual void onParticipantJoin(const UserInfo& user_) = 0;
//其它用户离开房间通知
virtual void onParticipantLeave(const UserInfo& user_) = 0;
//其它用户音视频发布状态变化通知
virtual void onParticipantStatusChange(const UserInfo& user_) = 0;

qiniu::RTCVideoInterface* _rtc_video_interface = _rtc_room_interface->ObtainVideoInterface();

int GetVideoCapDevList(std::vector<VideoCapDeviceInfo>& device_vec_)

int GetMicDevList(std::vector<qiniu::AudioDeviceInfo>& device_vec_)

int GetSpeakerDevList(std::vector<qiniu::AudioDeviceInfo>& device_vec_)

qiniu::RTCEngineInterface::Obtain()->Release();

/** 通过此静态方法获取接口指针
*
* @return 返回此接口的全局唯一实例的对象指针
*/
static RTCEngineInterface* Obtain();

/** 
* 释放此接口实例对象
*/
virtual void Release() = 0;

/** 初始化引擎，SDK中其它所有的接口及方法必须在本方法调用并成功后才能使用
*
* @return 成功返回0，其它可参考SDK错误码
*/
virtual int InitEngine() = 0;

/** 反初始化音频，调用此方法后，其它所有接口和方法均不能再使用
*
* @return 成功返回0，其它可参考SDK错误码
*/
virtual int UnInitEngine() = 0;

/** SDK日志输出，如果不调用此接口，或者设置日志文件名为空，则不输出任何日志文件
*
* @param[in] log_level_ 输出日志等级，按照输出的日志量划分
* @param[in] path_ 输入日志文件所在的目录，如果不存在，则创建此目录
* @param[in] file_name_ 日志输出目标文件名，如果为空，则不输出任何日志
*/
virtual void SetSdkLog(RTCLogLevel log_level_, const std::string& path_, 
    const std::string& file_name_) = 0;

/** 创建并返回指定房间 ID 的此接口指针
*
* @param[in] room_id_ 房间 ID，连麦房间的唯一标识
* @return 返回一个新的指定房间 ID 的接口实例指针
*
* @note 每个房间只需创建一次，创建成功后，开发者需自行保存此接口指针，切勿重复创建
*/
static RTCRoomInterface* Create(const std::string& room_id_);

/** 释放此接口指针
* 释放后，此指针无效
*/
virtual void Release() = 0;

/** 加入由 Create 接口创建的连麦房间
* @param[in] user_id_ 用户 ID，由开发者保证此 ID 全局唯一，重复 ID 将影响其它用户的正常使用
* @param[in] token_ 房间登录凭证
* @return 成功返回0，具体可参考错误码列表
* RTCRoomListener::onJoinResult(int result_)
*/
virtual int Join(const std::string& user_id_, const std::string& token_) = 0;

/** 离开房间
* @note 此方法为同步的，没有异步通知
*/
virtual int Leave() = 0;

/** 获取 Create 时传入的房间 ID
* @return 返回房间 ID
*/
virtual std::string GetRoomId() = 0;     

/** 设置回调接口指针 RTCRoomListener，
* @note 请在 Create 调用后，立即调用此接口，否则可能不能正确收到异步通知
*/
virtual void SetListener(RTCRoomListener* listener_) = 0;

/** 将某用户踢出此房间
* @param[in] reason_ 踢出此用户的原因，开发者可自定义
* @param[in] user_id_ 被踢出房间的用户 ID
* @return 成功返回0，具体可参考错误码列表
* @note 连麦 SDK 设计房间中，每个用户拥有任意的踢人权限，如果开发者需要设定某用户是否拥有踢人权限，请在应用层实现
*/
virtual int KickoutUser(int reason_, const std::string& user_id_) = 0;

/** 获取与此房间对应的视频模块接口实例指针
* @return 返回一个 RTCVideoInterface 接口指针
* @note 房间创建成功后，可以通过此接口获取视频模块接口指针，其资源由 SDK 内部进行管理，开发者无需管理
*/
virtual RTCVideoInterface* ObtainVideoInterface() = 0;

/** 获取与此房间对应的音频模块接口实例指针
* @return 返回一个 RTCAudioInterface 接口指针
* @note 房间创建成功后，可以通过此接口获取音频模块接口指针，其资源由 SDK 内部进行管理，开发者无需管理
*/
virtual RTCAudioInterface* ObtainAudioInterface() = 0;

/** 用户加入房间操作异步返回结果
* @param[in] result_ 加入房间操作结果，0：成功，其它请参考错误码列表
* @note 此通知方法可能会在子线程中触发，请不要在此方法中做只允许在主线程做的操作，如UI
*/
virtual void onJoinResult(int result_) = 0;

/** 此用户非正常原因离开房间异步通知
* @param[in] reason_ 用户离开房间原因，0代表被其它用户踢出房间；RTC_ERROR_USER_DUPLICATE_JOIN 代表有相同ID的用户在别处登录；开发者也可以使用自定义 值
* @param[in] fromId_ 触发此事件的源用户 ID，如踢出此用户的用户 ID
* @note 此时 SDK 内部已经释放房间资源，开发者无需再调用 Leave 接口了
*/
virtual void onLeaveIndication(int reason_, const std::string& from_id_) = 0;

/** 房间状态通知
* @param[in] status_ 房间状态通知, 具体请参考本接口文件中的枚举类型： enum qiniu::RoomStatus
*/
virtual void onRoomStatusNotify(RoomStatus status_) = 0;

/** 房间网络状态变化通知
* @param[in] status_ 房间网络状态，具体请参考本接口文件中的枚举类型： enum qiniu::ConnectionStatus
*/
virtual void onConnectionStatus(ConnectionStatus status_) = 0;

/** 其它用户加入房间通知
* @param[in] user_ 加入房间的用户信息
*/
virtual void onParticipantJoin(const UserInfo& user_) = 0;

/** 其它用户离开房间通知
* @param[in] user_ 离开房间的用户信息
*/
virtual void onParticipantLeave(const UserInfo& user_) = 0;

/** 用户状态变化通知, 如用户音视频发布状态的变化通知
* @param[in] user_ 用户状态信息
*/
virtual void onParticipantStatusChange(const UserInfo& user_) = 0;

/** 设置用来接收视频操作异步通知的接口
* @param listener_  实现了 RTCVideoListener 的实例指针
*/
virtual void SetListener(RTCVideoListener* listener_) = 0;

/** 发布本地摄像头，只有发布后，同房间的其它用户才能通过订阅查看到你的视频
* @param device_id_ 视频设备 ID，设备 ID 需开发者提前由 GetVideoCapDevList 方法获得，如果为空，则发布默认设备
* @param hwnd_ 渲染摄像头视频画面的窗口句柄，如果不需要预览，请传入空指针
* @param width_ 发布视频的宽度
* @param height_ 发布视频的高度
* @param fps_ 发布视频的帧率
* @param bitrate_ 发布视频的码率
* @return 0代表成功，其它请参考错误码列表
* @note RTCVideoListener:onCameraPublish 方法会通知发布结果
*/
virtual int PublishLocalCamera(const std::string& device_id_, const void* hwnd_, 
    int width_ = 640, int height_ = 480, int fps_ = 15, int bitrate_ = 500000) = 0;

/** 停止发布本地摄像头视频，停止发布后，其它用户将不能看到你的视频
* @param device_id_ 视频设备 ID，设备 ID 需开发者提前由 GetVideoCapDevList 方法获得，如果为空，则发布默认设备
* @return 0代表成功，请参考错误码列表 
* @note RTCVideoListener:onCameraUnpublish 方法会通知操作结果
*/
virtual int UnPublishLocalCamera(const std::string& device_id_) = 0;

/** 发布模拟数据源摄像头，由开发者提供外部采集数据，可以是原始图像数据，或者已编码数据
* @param[out] dev_id_ 发布视频后，开发者需自行记录此设备 ID
* @param[in] hwnd_ 用于渲染开发者传入的原始图像窗口句柄，如果为空，则不显示
* @param[in] format_ 开发者将要传入的视频数据格式，请参考本接口文件中的 FourCC
* @param[in] width_ 视频宽度
* @param[in] height_ 视频高度
* @param[in] fps_ 输入视频图像的帧率，此帧率由开发者自行控制
* @param[in] bitrate_ 视频码率，单位为 bps
* @return 0代表成功，其它请参考错误码列表
*/
virtual int PublishFakeCamera(std::string& device_id_, const void* hwnd_, 
    qiniu::FourCC format_, int width_ = 640, int height_ = 480,
    int fps_ = 15, int bitrate_ = 500000) = 0;

/** 停止发布模拟摄像头
* @param[out] dev_id_ 传入 PublishFakeCamera 返回的设备 ID
* @return 0代表成功，其它请参考错误码列表
*/
virtual int UnPublishFakeCamera(const std::string& device_id_) = 0;

/** 如果开发者使用了 PublishFakeCamera 方法，那么通过此方法输入原始未编码压缩的视频帧数据
* @param[in] timestamp_ms_ 视频帧时间戳，单位 ms
* @param[in] format_ 图像数据格式
* @param[in] width_ 输入图像宽度
* @param[in] height_ 输入图像高度
* @param[in] data_ 输入图像数据
* @param[in] len_ 输入图像数据长度
* @param[in] rotation_ 图像顺时针反转角度
* @param[in] mirror_ 是否需要左右反转
* @return 0代表成功，其它请参考错误码列表
*/
virtual int InputCapturedFrame(unsigned int timestamp_ms_, qiniu::FourCC format_, 
    int width_, int height_, const unsigned char* data_, unsigned int len_,
    int rotation_ = 0, bool mirror_ = false) = 0;

/** 如果开发者使用了 PublishFakeCamera 方法，并且希望传入已编码的视频帧数据，那么通过此方法可输入视频帧数据
* @param[in] timestamp_ms_ 视频帧事件戳，单位 ms
* @param[in] width_ 视频宽度
* @param[in] height_ 视频高度
* @param[in] data_ 输入数据
* @param[in] len_ 输入数据长度
* @return 0代表成功，其它请参考错误码列表
*/
virtual int InputEncodedFrame(unsigned int timestamp_ms_, int width_, int height_, 
    const unsigned char* data_, unsigned int len_) = 0;

/** 预览本地摄像头
* @param[in] device_id_ 设备 ID，设备 ID 需开发者提前由 GetVideoCapDevList 方法获得，如果为空，则使用默认设备
* @param[in] hwnd_ 视频渲染窗口句柄，如果为空，则不显示 
* @return 成功返回０，其它请参考错误码列表
* @note 这个方法是同步的
*/
virtual int PreviewLocalCamera(const std::string& device_id_, void* hwnd_) = 0;

/** 停止预览本地摄像头
* @param[in] device_id_ 设备 ID
* @return 成功返回０，其它请参考错误码列表
* @note 这个方法是同步的
*/
virtual int UnPreviewLocalCamera(const std::string& device_id_) = 0;

/** 订阅用户视频
* @param[in] user_id_ 用户 ID
* @param[in] hwnd_ 用于视频渲染的窗口句柄
* @return 成功返回０，其它请参考错误码列表
*/
virtual int Subscribe(const std::string& user_id_, void* hwnd_) = 0;

/** 停止订阅用户视频
* @param[in] user_id_ 用户ID
* @return 成功返回０，其它请参考错误码列表
*/
virtual int UnSubscribe(const std::string& user_id_) = 0;

/** 枚举本地视频采集设备
* @param[out] device_vec_ 将枚举信息输出到此参数中
* @return 成功返回设备数量，其它请参考错误码列表
*/
virtual int GetVideoCapDevList(std::vector<VideoCapDeviceInfo>& device_vec_) = 0;

/** 获取摄像头设备当前正在使用的采集信息
* @param[in] device_id_ 设备ID
* @param[out] capability_info_ 设备采集信息
* @return 成功返回０，其它请参考错误码列表
*/
virtual int GetRealCaptureCapability(const std::string& device_id_, 
    CameraCapabilityInfo& capability_info_) = 0;

/** 获取摄像头设备所有的设备采集信息，并输出到传入参数中
* @param[in] device_id_ 设备ID
* @param[out] capability_vec_ 指定设备所支持的采集参数列表
* @return 成功返回０，其它请参考错误码列表
*/
virtual int GetCameraCapability(const std::string& device_id_, CapabilitiesVec& capability_vec_) = 0;

/** 本地视频设备插入通知
* @param device_info_ 插入设备信息
*/
virtual void onCameraPlugin(const qiniu::VideoCapDeviceInfo& device_info_) = 0;

/** 本地视频设备拔出通知
* @param device_info_ 拔出设备信息
*/
virtual void onCameraPlugout(const qiniu::VideoCapDeviceInfo& device_info_) = 0;

/** 用户发布本地摄像头通知
* @param result_ 请参考错误码列表
* @param device_id_ 发布的摄像头设备 ID
*/
virtual void onLocalCameraPublish(int result_, const std::string& device_id_) = 0;

/** 用户取消发布本地摄像头通知
* @param result_ 请参考错误码列表
* @param device_id_ 取消发布的摄像头设备 ID
*/
virtual void onLocalCameraUnpublish(int result_, const std::string& device_id_) = 0;

/** 远端用户发布摄像头通知
* @param user_id_ 远端用户 ID
* @param device_id_ 设备 ID
*/
virtual void onRemoteCameraPublish(const std::string& user_id_ , const std::string& device_id_) = 0;

/** 远端用户取消发布摄像头通知
* @param user_id_ 远端用户 ID
* @param device_id_ 设备 ID
*/
virtual void onRemoteCameraUnpublish(const std::string& user_id_, const std::string& device_id_) = 0;

/** 用户订阅视频操作异步通知
* @param result_ 请参考错误码列表
* @param user_id_ 被订阅的用户 ID
*/
virtual void onSubscribe(int result_, const std::string& user_id_) = 0;

/** 用户取消订阅视频操作异步通知
* @param result_ 请参考错误码列表
* @param user_id_ 被取消订阅的用户 ID
*/
virtual void onUnsubscribe(int result_, const std::string& user_id_) = 0;

/** 设置用来接收音频操作异步通知的接口
* @param listener_  指向实现了 RTCAudioListener 接口的实例指针
*/
virtual void SetListener(RTCAudioListener* listener_) = 0;

/** 打开并发布本地音频，发布成功后房间内的其它用户便能听到发布者的声音
* @param[in] device_id_ 设备 ID，如果填空，则使用默认设备
* @return 成功返回０，其它请参考错误码列表
* @note 音频发布结果，在 RTCAudioListener:onMicrophonePublish 方法中进行通知
*/
virtual int PublishLocalMicrophone(const std::string& device_id_) = 0;

/** 关闭并停止发布本地音频
* @return 成功返回０，其它请参考错误码列表
* @note 音频停止发布结果，在 RTCAudioListener:onMicrophoneUnpublish 方法中进行通知
*/
virtual int UnPublishLocalMicrophone() = 0;

/** 静音当前正在使用的麦克风设备
* @return 成功返回０，其它请参考错误码列表
*/
virtual int MuteMicrophone() = 0;

/** 取消静音当前正在使用的麦克风设备
* @return 成功返回０，其它请参考错误码列表
*/
virtual int UnMuteMicrophone() = 0;

/** 判断当前是否静音了麦克风设备
*/
virtual bool IsMuteMicrophone() = 0;

/** 设置音频播放使用的音频输出设备
* @param[in] device_id_ 设备 ID
* @return 成功返回０，其它请参考错误码列表
*/
virtual int SetSpeakerDevice(const std::string& device_id_) = 0;

/** 静音当前正在使用的音频输出设备
* @return 成功返回０，其它请参考错误码列表
*/
virtual int MuteSpeaker() = 0;

/** 取消静音当前正在使用的音频输出设备
* @return 成功返回０，其它请参考错误码列表
*/
virtual int UnMuteSpeaker() = 0;

/** 判断当前是否静音了音频输出设备
*/
virtual bool IsSpeakerMute() = 0;

/** 获取本地音频输入设备列表
* @param[out] device_vec_ 将枚举到的音频输入设备信息输出到此参数
* @return 成功返回设备数量，否则返回错误码
*/
virtual int GetMicDevList(std::vector<qiniu::AudioDeviceInfo>& device_vec_) = 0;

/** 获取本地音频输出设备列表
* @param[out] device_vec_ 将枚举到的音频输出设备信息输出到此参数
* @return 成功返回设备数量，否则返回错误码
*/
virtual int GetSpeakerDevList(std::vector<qiniu::AudioDeviceInfo>& device_vec_) = 0;

/** 打开并发布本地麦克风设备操作异步通知
* @param result_ 请参考错误码列表
*/
virtual void onMicrophonePublish(int result_) = 0;

/** 用户关闭并停止发布本地麦克风设备操作异步通知
* @param result_ 请参考错误码列表
*/
virtual void onMicrophoneUnpublish(int result_) = 0;

/** 麦克风设备插入事件通知
* @param device_info_ 麦克风设备信息
*/
virtual void onMicrophonePlugin(const AudioDeviceInfo &device_info_) = 0;

/** 麦克风设备拔出事件通知
* @param device_info_ 麦克风设备信息
*/
virtual void onMicrophonePlugout(const AudioDeviceInfo &device_info_) = 0;

/** 音频输出设备插入事件通知
* @param device_info_ 音频输出设备信息
*/
virtual void onSpeakerPlugin(const AudioDeviceInfo &device_info_) = 0;

/** 音频输出设备拔出事件通知
* @param device_info_ 音频输出设备信息
*/
virtual void onSpeakerPlugout(const AudioDeviceInfo &device_info_) = 0;

/** 麦克风系统音量变化通知
* @param[in] volume_ 麦克风音量值, 0~100
*/
virtual void onMicrophoneVolumeChanged(unsigned int volume_) = 0;

/** 音频输出设备音量变化通知
* @param[in] volume_ 音频值, 0~100
*/
virtual void onSpeakerVolumeChanged(unsigned int volume_) = 0;