#include <nertc_engine_ex.h>

Inheritance diagram for nertc::IRtcEngineEx:

Public Member Functions
virtual NERtcConnectionStateType	getConnectionState ()=0

virtual int	muteLocalAudioStream (bool mute)=0

virtual int	setAudioProfile (NERtcAudioProfileType profile, NERtcAudioScenarioType scenario)=0

virtual int	subscribeRemoteAudioStream (uid_t uid, bool subscribe)=0

virtual int	setVideoConfig (const NERtcVideoConfig &config)=0

virtual int	enableDualStreamMode (bool enable)=0

virtual int	setLocalRenderMode (NERtcVideoScalingMode scaling_mode)=0

virtual int	setLocalVideoMirrorMode (NERtcVideoMirrorMode mirror_mode)=0

virtual int	setRemoteRenderMode (uid_t uid, NERtcVideoScalingMode scaling_mode)=0

virtual int	startVideoPreview ()=0

virtual int	stopVideoPreview ()=0

virtual int	muteLocalVideoStream (bool mute)=0

virtual int	setParameters (const char *parameters)=0

virtual int	setRecordingAudioFrameParameters (NERtcAudioFrameRequestFormat *format)=0

virtual int	setPlaybackAudioFrameParameters (NERtcAudioFrameRequestFormat *format)=0

virtual int	setAudioFrameObserver (INERtcAudioFrameObserver *observer)=0

virtual int	startAudioDump ()=0

virtual int	stopAudioDump ()=0

virtual int	startAudioMixing (NERtcCreateAudioMixingOption *option)=0

virtual int	stopAudioMixing ()=0

virtual int	pauseAudioMixing ()=0

virtual int	resumeAudioMixing ()=0

virtual int	setAudioMixingSendVolume (uint32_t volume)=0

virtual int	getAudioMixingSendVolume (uint32_t *volume)=0

virtual int	setAudioMixingPlaybackVolume (uint32_t volume)=0

virtual int	getAudioMixingPlaybackVolume (uint32_t *volume)=0

virtual int	getAudioMixingDuration (uint64_t *duration)=0

virtual int	getAudioMixingCurrentPosition (uint64_t *position)=0

virtual int	setAudioMixingPosition (uint64_t seek_position)=0

virtual int	playEffect (uint32_t effect_id, NERtcCreateAudioEffectOption *option)=0

virtual int	stopEffect (uint32_t effect_id)=0

virtual int	stopAllEffects ()=0

virtual int	pauseEffect (uint32_t effect_id)=0

virtual int	resumeEffect (uint32_t effect_id)=0

virtual int	pauseAllEffects ()=0

virtual int	resumeAllEffects ()=0

virtual int	setEffectSendVolume (uint32_t effect_id, uint32_t volume)=0

virtual int	getEffectSendVolume (uint32_t effect_id, uint32_t *volume)=0

virtual int	setEffectPlaybackVolume (uint32_t effect_id, uint32_t volume)=0

virtual int	getEffectPlaybackVolume (uint32_t effect_id, uint32_t *volume)=0

virtual int	enableEarback (bool enabled, uint32_t volume)=0

virtual int	setEarbackVolume (uint32_t volume)=0

virtual int	setStatsObserver (IRtcMediaStatsObserver *observer)=0

virtual int	enableAudioVolumeIndication (bool enable, uint64_t interval)=0

virtual int	startScreenCaptureByScreenRect (const NERtcRectangle &screen_rect, const NERtcRectangle &region_rect, const NERtcScreenCaptureParameters &capture_params)=0

virtual int	startScreenCaptureByDisplayId (unsigned int display_id, const NERtcRectangle &region_rect, const NERtcScreenCaptureParameters &capture_params)=0

virtual int	startScreenCaptureByWindowId (void *window_id, const NERtcRectangle &region_rect, const NERtcScreenCaptureParameters &capture_params)=0

virtual int	updateScreenCaptureRegion (const NERtcRectangle &region_rect)=0

virtual int	stopScreenCapture ()=0

virtual int	pauseScreenCapture ()=0

virtual int	resumeScreenCapture ()=0

virtual int	setExternalVideoSource (bool enabled)=0

virtual int	pushExternalVideoFrame (NERtcVideoFrame *frame)=0

virtual const char *	getVersion (int *build)=0

virtual const char *	getErrorDescription (int error_code)=0

virtual void	uploadSdkInfo ()=0

virtual int	addLiveStreamTask (const NERtcLiveStreamTaskInfo &info)=0

virtual int	updateLiveStreamTask (const NERtcLiveStreamTaskInfo &info)=0

virtual int	removeLiveStreamTask (const char *task_id)=0

Public Member Functions inherited from nertc::IRtcEngine
virtual int	initialize (const NERtcEngineContext &context)=0

virtual void	release (bool sync=false)=0

virtual int	setChannelProfile (NERtcChannelProfileType profile)=0

virtual int	joinChannel (const char token, const char channel_name, uid_t uid)=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	subscribeRemoteVideoStream (uid_t uid, NERtcRemoteVideoStreamType type, bool subscribe)=0

Detailed Description

RtcEngine 类提供了供 App 调用的主要接口方法。

IRtcEngineEx 是 NERTC SDK 的扩展接口类。创建一个 IRtcEngine 对象并调用这个对象的方法可以激活 NERTC SDK 的通信功能。

Member Function Documentation

virtual int nertc::IRtcEngineEx::addLiveStreamTask ( const NERtcLiveStreamTaskInfo & info )

pure virtual

添加房间推流任务，成功添加后当前用户可以收到该直播流的状态通知。通话中有效。

Parameters

[in] info 直播任务信息。 #NERtcLiveStreamTaskInfo

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::enableAudioVolumeIndication	(	bool	enable,
		uint64_t	interval
	)

pure virtual

启用说话者音量提示。该方法允许 SDK 定期向 App 反馈当前谁在说话以及说话者的音量。

启用该方法后，无论频道内是否有人说话，都会在 onRemoteAudioVolumeIndication 回调中按设置的间隔时间返回音量提示。

Parameters

enable	是否启用说话者音量提示。
interval	指定音量提示的时间间隔，单位为毫秒。必须设置为 100 毫秒的整数倍值。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::enableDualStreamMode ( bool enable )

pure virtual

设置视频双流发送。

Note: 调用该方法控制是否支持发送双流，只对摄像头数据生效，自定义输入、取屏等无效。设置后，会在摄像头重启后生效。

Parameters

[in]

enable

true: 双流发送（默认）
false: 只发送一个流

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::enableEarback	(	bool	enabled,
		uint32_t	volume
	)

pure virtual

开启或关闭耳返。

请在频道内调用该方法。

Parameters

[in]	enabled	开启或关闭。
[in]	volume	耳返音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::getAudioMixingCurrentPosition ( uint64_t * position )

pure virtual

获取音乐文件的播放进度。

该方法获取当前伴奏播放进度，单位为毫秒。请在频道内调用该方法。

Parameters

[out] position 伴奏播放进度，单位为毫秒。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::getAudioMixingDuration ( uint64_t * duration )

pure virtual

获取伴奏时长。

该方法获取伴奏时长，单位为毫秒。请在频道内调用该方法。

Parameters

[out] duration 伴奏时长，单位为毫秒。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::getAudioMixingPlaybackVolume ( uint32_t * volume )

pure virtual

获取伴奏播放音量。

该方法获取混音里伴奏的播放音量大小。请在频道内调用该方法。

Parameters

[out] volume 伴奏播放音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::getAudioMixingSendVolume ( uint32_t * volume )

pure virtual

获取伴奏发送音量。

该方法获取混音里伴奏的发送音量大小。请在频道内调用该方法。

Parameters

[out] volume 伴奏发送音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual NERtcConnectionStateType nertc::IRtcEngineEx::getConnectionState ( )

pure virtual

Gets the connection state of the SDK.

Returns: NERtcConnectionStateType.

virtual int nertc::IRtcEngineEx::getEffectPlaybackVolume	(	uint32_t	effect_id,
		uint32_t *	volume
	)

pure virtual

获取音效播放音量。

该方法获取音效的播放音量大小。请在频道内调用该方法。

Parameters

[in]	effect_id	指定音效的 ID。每个音效均有唯一的 ID。
[out]	volume	音效播放音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::getEffectSendVolume	(	uint32_t	effect_id,
		uint32_t *	volume
	)

pure virtual

获取音效发送音量。

该方法获取音效的发送音量大小。请在频道内调用该方法。

Parameters

[in]	effect_id	指定音效的 ID。每个音效均有唯一的 ID。
[out]	volume	音效发送音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual const char* nertc::IRtcEngineEx::getErrorDescription ( int error_code )

pure virtual

获取错误描述。

Parameters

[in] error_code NERtcErrorCode 。来自 onError 提供的错误码。

Returns: 详细错误码描述

virtual const char* nertc::IRtcEngineEx::getVersion ( int * build )

pure virtual

查询 SDK 版本号。

Parameters

[out] build 编译号。

Returns: 当前的 SDK 版本号，格式为字符串，如1.0.0.

virtual int nertc::IRtcEngineEx::muteLocalAudioStream ( bool mute )

pure virtual

开关本地音频发送。该方法用于允许/禁止往网络发送本地音频流。

Note: 该方法不影响录音状态，因为并没有禁用录音设备。

Parameters

[in]

mute

静音/取消静音:

true: 静音本地音频
false: 取消静音本地音频（默认）

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::muteLocalVideoStream ( bool mute )

pure virtual

开关本地视频发送。

Note: 调用该方法禁视频流时，SDK 不再发送本地视频流，但摄像头仍然处于工作状态。相比于 enableLocalVideo (false) 用于控制本地视频流发送的方法，该方法响应速度更快。该方法不影响本地视频流获取，没有禁用摄像头。

Parameters

[in]

mute

true: 不发送本地视频流
false: 发送本地视频流（默认）

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::pauseAllEffects ( )

pure virtual

暂停所有音效文件播放。

请在频道内调用该方法。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::pauseAudioMixing ( )

pure virtual

暂停播放伴奏。

该方法暂停播放伴奏。请在频道内调用该方法。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::pauseEffect ( uint32_t effect_id )

pure virtual

暂停音效文件播放。

请在频道内调用该方法。

Parameters

[in] effect_id 指定音效的 ID。每个音效均有唯一的 ID。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::pauseScreenCapture ( )

pure virtual

暂停屏幕共享。

Returns

0: 方法调用成功
其他: 方法调用失败

virtual int nertc::IRtcEngineEx::playEffect	(	uint32_t	effect_id,
		NERtcCreateAudioEffectOption *	option
	)

pure virtual

播放指定音效文件。

你可以多次调用该方法，通过传入不同的音效文件的 effect_id 和 option ，同时播放多个音效文件，实现音效叠加。为获得最佳用户体验，我们建议同时播放的音效文件不要超过 3 个。成功调用该方法后，如果播放结束，本地会触发 onAudioEffectFinished 回调。

Note: 请在频道内调用该方法，如果在频道外调用该方法可能会出现问题。

Parameters

[in]	effect_id	指定音效的 ID。每个音效均有唯一的 ID。
[in]	option	创建音效任务配置的选项，包括混音任务类型、混音文件全路径或URL等。支持的音频格式包括: AAC、MP3 和 WAVE。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::pushExternalVideoFrame ( NERtcVideoFrame * frame )

pure virtual

推送外部视频源数据输入

该方法将数据帧设置给内部引擎。

Note: 该方法设置内部引擎为启用状态，在 leaveChannel 后不再有效。

Parameters

[in] frame 视频桢数据:

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::removeLiveStreamTask ( const char * task_id )

pure virtual

删除房间推流任务。通话中有效。

Parameters

[in] task_id 直播任务id

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::resumeAllEffects ( )

pure virtual

恢复播放所有音效文件。

请在频道内调用该方法。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::resumeAudioMixing ( )

pure virtual

恢复播放伴奏。

该方法恢复混音，继续播放伴奏。请在频道内调用该方法。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::resumeEffect ( uint32_t effect_id )

pure virtual

恢复播放指定音效文件。

请在频道内调用该方法。

Parameters

[in] effect_id 指定音效的 ID。每个音效均有唯一的 ID。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::resumeScreenCapture ( )

pure virtual

恢复屏幕共享。

Returns

0: 方法调用成功
其他: 方法调用失败

virtual int nertc::IRtcEngineEx::setAudioFrameObserver ( INERtcAudioFrameObserver * observer )

pure virtual

注册语音观测器对象。joinChannel 前/后都允许更改设置。

该方法用于注册语音观测器对象，即注册回调。当需要引擎给出 onAudioFrameDidRecord 或 onAudioFrameWillPlayback 回调时，需要使用该方法注册回调。

Parameters

observer 接口对象实例。如果传入 NULL，则取消注册，同时会清理NERtcAudioFrameRequestFormat相关设置。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setAudioMixingPlaybackVolume ( uint32_t volume )

pure virtual

调节伴奏播放音量。

该方法调节混音里伴奏的播放音量大小。请在频道内调用该方法。

Parameters

[in] volume 伴奏音量范围为 0~100。默认 100 为原始文件音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setAudioMixingPosition ( uint64_t seek_position )

pure virtual

设置音乐文件的播放位置。

该方法可以设置音频文件的播放位置，这样你可以根据实际情况播放文件，而非从头到尾播放整个文件。

Parameters

[in] seek_position 进度条位置，单位为毫秒。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setAudioMixingSendVolume ( uint32_t volume )

pure virtual

调节伴奏发送音量。

该方法调节混音里伴奏的发送音量大小。请在频道内调用该方法。

Parameters

[in] volume 伴奏音量范围为 0~100。默认 100 为原始文件音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setAudioProfile	(	NERtcAudioProfileType	profile,
		NERtcAudioScenarioType	scenario
	)

pure virtual

设置音频编码属性。

Note

该方法需要在 joinChannel 之前设置好， joinChannel 之后设置不生效。
音乐场景下，建议将 profile 设置为 kNERtcAudioProfileHighQuality (4).

Parameters

[in]	profile	设置采样率，码率，编码模式和声道数: NERtcAudioProfileType.
[in]	scenario	设置音频应用场景: NERtcAudioScenarioType.

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setEarbackVolume ( uint32_t volume )

pure virtual

设置耳返音量。

请在频道内调用该方法。

Parameters

[in] volume 耳返音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setEffectPlaybackVolume	(	uint32_t	effect_id,
		uint32_t	volume
	)

pure virtual

调节音效播放音量。

该方法调节音效的播放音量大小。请在频道内调用该方法。

Parameters

[in]	effect_id	指定音效的 ID。每个音效均有唯一的 ID。
[in]	volume	音效音量范围为 0~100。默认 100 为原始文件音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setEffectSendVolume	(	uint32_t	effect_id,
		uint32_t	volume
	)

pure virtual

调节音效发送音量。

该方法调节音效的发送音量大小。请在频道内调用该方法。

Parameters

[in]	effect_id	指定音效的 ID。每个音效均有唯一的 ID。
[in]	volume	音效音量范围为 0~100。默认 100 为原始文件音量。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setExternalVideoSource ( bool enabled )

pure virtual

开启或关闭外部视频源数据输入

该方法启用外部视频数据输入功能。并且需要通过IVideoDeviceManager::setDevice 设置kNERtcExternalVideoDeviceID为外部视频输入源ID

Note: 该方法设置内部引擎为启用状态，在 leaveChannel 后仍然有效。

Parameters

[in]

enabled

是否外部视频源数据输入:

true: 开启外部视频源数据输入；
false: 关闭外部视频源数据输入 (默认)。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setLocalRenderMode ( NERtcVideoScalingMode scaling_mode )

pure virtual

设置本地视图显示模式。

该方法设置本地视图显示模式。 App 可以多次调用此方法更改显示模式。

Parameters

[in] scaling_mode 视频显示模式: NERtcVideoScalingMode

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setLocalVideoMirrorMode ( NERtcVideoMirrorMode mirror_mode )

pure virtual

设置本地视频镜像模式。

该方法设置本地视频镜像模式。 App 可以多次调用此方法更改镜像模式。

Parameters

[in] mirror_mode 视频镜像模式: NERtcVideoMirrorMode

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setParameters ( const char * parameters )

pure virtual

通过 JSON 配置 SDK 提供技术预览或特别定制功能。以标准化方式公开 JSON 选项。

Parameters

[in] parameters JSON 字符串形式的参数

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setPlaybackAudioFrameParameters ( NERtcAudioFrameRequestFormat * format )

pure virtual

设置播放的声音格式。该方法设置 onAudioFrameWillPlayback 回调的播放声音格式。

joinChannel 前/后都允许更改设置。取消监听后，后重置为空。

Parameters

format 指定 onAudioFrameWillPlayback 中返回数据的采样率和数据的通道数。允许传入 NULL，默认为 NULL。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setRecordingAudioFrameParameters ( NERtcAudioFrameRequestFormat * format )

pure virtual

设置录制的声音格式。该方法设置 onAudioFrameDidRecord 回调的录制声音格式。

joinChannel 前/后都允许更改设置。取消监听后，后重置为空。

Parameters

format 指定 onAudioFrameDidRecord 中返回数据的采样率和数据的通道数。允许传入 NULL，默认为 NULL。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setRemoteRenderMode	(	uid_t	uid,
		NERtcVideoScalingMode	scaling_mode
	)

pure virtual

设置远端视图显示模式。

该方法设置远端视图显示模式。App 可以多次调用此方法更改显示模式。

Parameters

[in]	uid	远端用户 ID。
[in]	scaling_mode	视频显示模式: NERtcVideoScalingMode

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setStatsObserver ( IRtcMediaStatsObserver * observer )

pure virtual

注册统计信息观测器。

Parameters

[in] observer 统计信息观测器

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::setVideoConfig ( const NERtcVideoConfig & config )

pure virtual

设置视频配置。

该方法设置视频配置。每个属性对应一套视频参数，如分辨率等，会在摄像头重启后生效。所有设置的参数均为理想情况下的最大值。当视频引擎因网络环境等原因无法达到设置的分辨率的最大值时，会取最接近最大值的那个值。

Parameters

[in] config 视频配置: NERtcVideoConfig

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::startAudioDump ( )

pure virtual

开启音频dump。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::startAudioMixing ( NERtcCreateAudioMixingOption * option )

pure virtual

开始播放伴奏。

指定本地或在线音频文件来和录音设备采集的音频流进行混音。成功调用该方法后，如果播放状态改变，本地会触发 onAudioMixingStateChanged 回调。

Note: 请在频道内调用该方法，如果在频道外调用该方法可能会出现问题。

Parameters

[in] option 创建混音任务配置的选项，包括混音任务类型、混音文件全路径或URL等。支持的音频格式包括: AAC、MP3 和 WAVE。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::startScreenCaptureByDisplayId	(	unsigned int	display_id,
		const NERtcRectangle &	region_rect,
		const NERtcScreenCaptureParameters &	capture_params
	)

pure virtual

通过屏幕 ID 共享屏幕。共享一个屏幕或该屏幕的部分区域。用户需要在该方法中指定想要共享的屏幕 ID。

该方法仅适用于 macOS。

Parameters

display_id	指定待共享的屏幕 ID。开发者需要通过该参数指定你要共享的那个屏幕。
region_rect	（可选）指定待共享的区域相对于整个窗口的位置。如果设置的共享区域超出了窗口的边界，则只共享窗口内的内容；如果宽或高为 0，则共享整个窗口。
capture_params	屏幕共享的编码参数配置。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::startScreenCaptureByScreenRect	(	const NERtcRectangle &	screen_rect,
		const NERtcRectangle &	region_rect,
		const NERtcScreenCaptureParameters &	capture_params
	)

pure virtual

通过指定区域共享屏幕。共享一个屏幕或该屏幕的部分区域。用户需要在该方法中指定想要共享的屏幕区域。

该方法仅适用于 Windows。

Parameters

screen_rect	指定待共享的屏幕相对于虚拟屏的位置。
region_rect	(可选) 指定待共享区域相对于整个屏幕屏幕的位置。如果设置的共享区域超出了屏幕的边界，则只共享屏幕内的内容；如果将 width 或 height 设为 0, 则共享整个屏幕。
capture_params	屏幕共享的编码参数配置。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::startScreenCaptureByWindowId	(	void *	window_id,
		const NERtcRectangle &	region_rect,
		const NERtcScreenCaptureParameters &	capture_params
	)

pure virtual

通过窗口 ID 共享窗口。共享一个窗口或该窗口的部分区域。用户需要在该方法中指定想要共享的窗口 ID。

Parameters

window_id	指定待共享的窗口 ID。
region_rect	（可选）指定待共享的区域相对于整个窗口的位置。如果设置的共享区域超出了窗口的边界，则只共享窗口内的内容；如果宽或高为 0，则共享整个窗口。
capture_params	屏幕共享的编码参数配置。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::startVideoPreview ( )

pure virtual

开启视频预览。

该方法用于在进入频道前启动本地视频预览。调用该 API 前，必须:

调用 setupLocalVideoCanvas 设置预览窗口；

Note: 启用了本地视频预览后，在进入频道前，本地预览必须先关闭，需要调用 stopVideoPreview 。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::stopAllEffects ( )

pure virtual

停止播放所有音效文件。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::stopAudioDump ( )

pure virtual

结束音频dump。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::stopAudioMixing ( )

pure virtual

停止播放伴奏。

该方法停止播放伴奏。请在频道内调用该方法。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::stopEffect ( uint32_t effect_id )

pure virtual

停止播放指定音效文件。

请在频道内调用该方法。

Parameters

[in] effect_id 指定音效的 ID。每个音效均有唯一的 ID。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::stopScreenCapture ( )

pure virtual

停止屏幕共享。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::stopVideoPreview ( )

pure virtual

停止视频预览。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::subscribeRemoteAudioStream	(	uid_t	uid,
		bool	subscribe
	)

pure virtual

订阅／取消订阅指定音频流。

Parameters

[in]	uid	指定用户的 ID
[in]	subscribe	true: 订阅指定音频流（默认）； false: 取消订阅指定音频流。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::updateLiveStreamTask ( const NERtcLiveStreamTaskInfo & info )

pure virtual

更新修改房间推流任务。通话中有效。

Parameters

[in] info 直播任务信息。 #NERtcLiveStreamTaskInfo

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual int nertc::IRtcEngineEx::updateScreenCaptureRegion ( const NERtcRectangle & region_rect )

pure virtual

在共享屏幕或窗口时，更新共享的区域。

Parameters

region_rect （可选）指定待共享的区域相对于整个窗口的位置。如果设置的共享区域超出了窗口的边界，则只共享窗口内的内容；如果宽或高为 0，则共享整个窗口。

Returns

0: 方法调用成功；
其他: 方法调用失败。

virtual void nertc::IRtcEngineEx::uploadSdkInfo ( )

pure virtual

上传SDK 信息（如log文件和Audio dump文件）。

Returns: void

The documentation for this class was generated from the following file:

nertc_sdk_windows/api/nertc_engine_ex.h

Public Member Functions

Detailed Description

Member Function Documentation