#include <nertc_engine_event_handler_ex.h>

类 nertc::IRtcEngineEventHandlerEx 继承关系图:

Public 成员函数
virtual void	onUserSubStreamVideoStart (uid_t uid, NERtcVideoProfileType max_profile)

virtual void	onUserSubStreamVideoStop (uid_t uid)

virtual void	onScreenCaptureStatus (NERtcScreenCaptureStatus status)

virtual void	onUserVideoProfileUpdate (uid_t uid, NERtcVideoProfileType max_profile)

virtual void	onUserSubStreamAudioStart (uid_t uid)

virtual void	onUserSubStreamAudioStop (uid_t uid)

virtual void	onUserAudioMute (uid_t uid, bool mute)

virtual void	onUserSubStreamAudioMute (uid_t uid, bool mute)

virtual void	onUserVideoMute (uid_t uid, bool mute)

virtual void	onUserVideoMute (NERtcVideoStreamType videoStreamType, uid_t uid, bool mute)

virtual void	onAudioDeviceStateChanged (const char device_id[kNERtcMaxDeviceIDLength], NERtcAudioDeviceType device_type, NERtcAudioDeviceState device_state)

virtual void	onAudioDefaultDeviceChanged (const char device_id[kNERtcMaxDeviceIDLength], NERtcAudioDeviceType device_type)

virtual void	onVideoDeviceStateChanged (const char device_id[kNERtcMaxDeviceIDLength], NERtcVideoDeviceType device_type, NERtcVideoDeviceState device_state)

virtual void	onFirstAudioDataReceived (uid_t uid)

virtual void	onFirstVideoDataReceived (uid_t uid)

virtual void	onFirstVideoDataReceived (NERtcVideoStreamType type, uid_t uid)

virtual void	onFirstAudioFrameDecoded (uid_t uid)

virtual void	onFirstVideoFrameDecoded (uid_t uid, uint32_t width, uint32_t height)

virtual void	onFirstVideoFrameDecoded (NERtcVideoStreamType type, uid_t uid, uint32_t width, uint32_t height)

virtual void	onCaptureVideoFrame (void *data, NERtcVideoType type, uint32_t width, uint32_t height, uint32_t count, uint32_t offset[kNERtcMaxPlaneCount], uint32_t stride[kNERtcMaxPlaneCount], NERtcVideoRotation rotation)

virtual void	onAudioMixingStateChanged (NERtcAudioMixingState state, NERtcAudioMixingErrorCode error_code)

virtual void	onAudioMixingTimestampUpdate (uint64_t timestamp_ms)

virtual void	onAudioEffectFinished (uint32_t effect_id)

virtual void	onLocalAudioVolumeIndication (int volume)

virtual void	onLocalAudioVolumeIndication (int volume, bool enable_vad)

virtual void	onRemoteAudioVolumeIndication (const NERtcAudioVolumeInfo *speakers, unsigned int speaker_number, int total_volume)

virtual void	onAddLiveStreamTask (const char task_id, const char url, int error_code)

virtual void	onUpdateLiveStreamTask (const char task_id, const char url, int error_code)

virtual void	onRemoveLiveStreamTask (const char *task_id, int error_code)

virtual void	onLiveStreamState (const char task_id, const char url, NERtcLiveStreamStateCode state)

virtual void	onAudioHowling (bool howling)

virtual void	onRecvSEIMsg (uid_t uid, const char *data, uint32_t dataSize)

virtual void	onAudioRecording (NERtcAudioRecordingCode code, const char *file_path)

virtual void	onMediaRelayStateChanged (NERtcChannelMediaRelayState state, const char *channel_name)

virtual void	onMediaRelayEvent (NERtcChannelMediaRelayEvent event, const char *channel_name, NERtcErrorCode error)

virtual void	onLocalPublishFallbackToAudioOnly (bool is_fallback, NERtcVideoStreamType stream_type)

virtual void	onRemoteSubscribeFallbackToAudioOnly (uid_t uid, bool is_fallback, NERtcVideoStreamType stream_type)

virtual void	onLastmileQuality (NERtcNetworkQualityType quality)

virtual void	onLastmileProbeResult (const NERtcLastmileProbeResult &result)

virtual void	onMediaRightChange (bool is_audio_banned, bool is_video_banned)

virtual void	onCheckNECastAudioDriverResult (NERtcInstallCastAudioDriverResult result)

virtual void	onVirtualBackgroundSourceEnabled (bool enabled, NERtcVirtualBackgroundSourceStateReason reason)

virtual void	onLocalVideoWatermarkState (NERtcVideoStreamType videoStreamType, NERtcLocalVideoWatermarkState state)

Public 成员函数继承自 nertc::IRtcEngineEventHandler
virtual void	onError (int error_code, const char *msg)

virtual void	onWarning (int warn_code, const char *msg)

virtual void	onReleasedHwResources (NERtcErrorCode result)

virtual void	onJoinChannel (channel_id_t cid, uid_t uid, NERtcErrorCode result, uint64_t elapsed)

virtual void	onReconnectingStart (channel_id_t cid, uid_t uid)

virtual void	onConnectionStateChange (NERtcConnectionStateType state, NERtcReasonConnectionChangedType reason)

virtual void	onRejoinChannel (channel_id_t cid, uid_t uid, NERtcErrorCode result, uint64_t elapsed)

virtual void	onLeaveChannel (NERtcErrorCode result)

virtual void	onDisconnect (NERtcErrorCode reason)

virtual void	onClientRoleChanged (NERtcClientRole oldRole, NERtcClientRole newRole)

virtual void	onUserJoined (uid_t uid, const char *user_name)

virtual void	onUserLeft (uid_t uid, NERtcSessionLeaveReason reason)

virtual void	onUserAudioStart (uid_t uid)

virtual void	onUserAudioStop (uid_t uid)

virtual void	onUserVideoStart (uid_t uid, NERtcVideoProfileType max_profile)

virtual void	onUserVideoStop (uid_t uid)

详细描述

IRtcEngineEventHandlerEx 回调扩展接口类用于 SDK 向 App 发送回调事件通知，App 通过继承该接口类的方法获取 SDK 的事件通知。
接口类的所有方法都有缺省（空）实现，App 可以根据需要只继承关心的事件。在回调方法中，App 不应该做耗时或者调用可能会引起阻塞的 API（如开启音频或视频等），否则可能影响 SDK 的运行。

成员函数说明

◆ onAddLiveStreamTask()

virtual void nertc::IRtcEngineEventHandlerEx::onAddLiveStreamTask	(	const char *	task_id,
		const char *	url,
		int	error_code
	)

inlinevirtual

通知添加直播任务结果。
该回调异步返回 addLiveStreamTask 接口的调用结果；实际推流状态参考 onLiveStreamState

参数

task_id	任务id
url	推流地址
error_code	结果 0: 调用成功；其他: 调用失败。

◆ onAudioDefaultDeviceChanged()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioDefaultDeviceChanged	(	const char	device_id[kNERtcMaxDeviceIDLength],
		NERtcAudioDeviceType	device_type
	)

inlinevirtual

音频默认设备更改的回调。

参数

device_id	设备ID。
device_type	音频设备类型。

◆ onAudioDeviceStateChanged()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioDeviceStateChanged	(	const char	device_id[kNERtcMaxDeviceIDLength],
		NERtcAudioDeviceType	device_type,
		NERtcAudioDeviceState	device_state
	)

inlinevirtual

音频设备状态更改的回调。

参数

device_id	设备ID。
device_type	音频设备类型。详细信息请参考 NERtcAudioDeviceType。
device_state	音频设备状态。

◆ onAudioEffectFinished()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioEffectFinished ( uint32_t effect_id )

inlinevirtual

本地音效文件播放已结束回调。
当播放音效结束后，会触发该回调。

参数

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

◆ onAudioHowling()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioHowling ( bool howling )

inlinevirtual

检测到啸叫回调。
当声源与扩音设备之间因距离过近时，可能会产生啸叫。NERTC SDK 支持啸叫检测，当检测到有啸叫信号产生的时候，自动触发该回调直至啸叫停止。App 应用层可以在收到啸叫回调时，提示用户静音麦克风，或直接静音麦克风。

注解: 啸叫检测功能一般用于语音聊天室或在线会议等纯人声环境，不推荐在包含背景音乐的娱乐场景中使用。

参数

howling

是否出现啸叫

true: 啸叫。
false: 正常。

◆ onAudioMixingStateChanged()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioMixingStateChanged	(	NERtcAudioMixingState	state,
		NERtcAudioMixingErrorCode	error_code
	)

inlinevirtual

本地用户的音乐文件播放状态改变回调。
调用 startAudioMixing 播放混音音乐文件后，当音乐文件的播放状态发生改变时，会触发该回调。

如果播放音乐文件正常结束，state 会返回相应的状态码 kNERtcAudioMixingStateFinished，error_code 返回 kNERtcAudioMixingErrorOK。
如果播放出错，则返回状态码 kNERtcAudioMixingStateFailed，error_code 返回相应的出错原因。
如果本地音乐文件不存在、文件格式不支持、无法访问在线音乐文件 URL，error_code都会返回 kNERtcAudioMixingErrorCanNotOpen。
参数

state 音乐文件播放状态，详见 NERtcAudioMixingState.

error_code 错误码，详见 NERtcAudioMixingErrorCode.

◆ onAudioMixingTimestampUpdate()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioMixingTimestampUpdate ( uint64_t timestamp_ms )

inlinevirtual

本地用户的音乐文件播放进度回调。
调用 startAudioMixing 播放混音音乐文件后，当音乐文件的播放进度改变时，会触发该回调。

参数

timestamp_ms 音乐文件播放进度，单位为毫秒

◆ onAudioRecording()

virtual void nertc::IRtcEngineEventHandlerEx::onAudioRecording	(	NERtcAudioRecordingCode	code,
		const char *	file_path
	)

inlinevirtual

音频录制状态回调。

参数

code	音频录制状态码。详细信息请参考 NERtcAudioRecordingCode。
file_path	音频录制文件保存路径。

◆ onCaptureVideoFrame()

virtual void nertc::IRtcEngineEventHandlerEx::onCaptureVideoFrame	(	void *	data,
		NERtcVideoType	type,
		uint32_t	width,
		uint32_t	height,
		uint32_t	count,
		uint32_t	offset[kNERtcMaxPlaneCount],
		uint32_t	stride[kNERtcMaxPlaneCount],
		NERtcVideoRotation	rotation
	)

inlinevirtual

采集视频数据回调。

参数

data	采集视频数据。
type	视频类型。
width	视频宽度。
height	视频高度。
count	视频Plane Count。
offset	视频offset。
stride	视频stride。
rotation	视频旋转角度。

◆ onCheckNECastAudioDriverResult()

virtual void nertc::IRtcEngineEventHandlerEx::onCheckNECastAudioDriverResult ( NERtcInstallCastAudioDriverResult result )

inlinevirtual

收到检测安装声卡的内容回调（仅适用于 Mac 系统）。
在 Mac 系统上，您可以通过调用 checkNECastAudioDriver 为当前系统安装一个音频驱动，并让 SDK 通过该音频驱动捕获当前 Mac 系统播放出的声音。

参数

result 安装虚拟声卡的结果。详细信息请参考 NERtcInstallCastAudioDriverResult。

◆ onFirstAudioDataReceived()

virtual void nertc::IRtcEngineEventHandlerEx::onFirstAudioDataReceived ( uid_t uid )

inlinevirtual

已接收到远端音频首帧的回调。

参数

uid	远端用户 ID，指定是哪个用户的音频流。

◆ onFirstAudioFrameDecoded()

virtual void nertc::IRtcEngineEventHandlerEx::onFirstAudioFrameDecoded ( uid_t uid )

inlinevirtual

已解码远端音频首帧的回调。

参数

uid	远端用户 ID，指定是哪个用户的音频流。

◆ onFirstVideoDataReceived() [1/2]

virtual void nertc::IRtcEngineEventHandlerEx::onFirstVideoDataReceived	(	NERtcVideoStreamType	type,
		uid_t	uid
	)

inlinevirtual

已显示首帧远端视频的回调。
当远端视频的第一帧画面显示在视窗上时，会触发此回调。

自从: V4.6.20

参数说明

参数名称	类型	描述
type	see NERtcVideoStreamType	视频通道类型： kNERTCVideoStreamMain：主流。 kNERtcVideoStreamSub：辅流。
uid	uid_t	用户 ID，提示是哪个用户的视频流。

◆ onFirstVideoDataReceived() [2/2]

virtual void nertc::IRtcEngineEventHandlerEx::onFirstVideoDataReceived ( uid_t uid )

inlinevirtual

已显示首帧远端视频的回调。第一帧远端视频显示在视图上时，触发此调用。

参数

uid	用户 ID，指定是哪个用户的视频流。

◆ onFirstVideoFrameDecoded() [1/2]

virtual void nertc::IRtcEngineEventHandlerEx::onFirstVideoFrameDecoded	(	NERtcVideoStreamType	type,
		uid_t	uid,
		uint32_t	width,
		uint32_t	height
	)

inlinevirtual

已接收到远端视频首帧并完成解码的回调。
当 SDK 收到远端视频的第一帧并解码成功时，会触发该回调。应用层可在该回调中设置此用户的视频画布。

自从: V4.6.20

参数说明

参数名称	类型	描述
type	see NERtcVideoStreamType	视频通道类型： kNERTCVideoStreamMain：主流。 kNERtcVideoStreamSub：辅流。
uid	uid_t	用户 ID，提示是哪个用户的视频流。
width	uint32_t	首帧视频的宽度，单位为 px。
height	uint32_t	首帧视频的高度，单位为 px。

◆ onFirstVideoFrameDecoded() [2/2]

virtual void nertc::IRtcEngineEventHandlerEx::onFirstVideoFrameDecoded	(	uid_t	uid,
		uint32_t	width,
		uint32_t	height
	)

inlinevirtual

已接收到远端视频并完成解码的回调。
引擎收到第一帧远端视频流并解码成功时，触发此调用。

注解: 该回调仅在接收远端用户的主流视频首帧并完成解码时会触发，若您希望同时接收到接收辅流的相关通知，请监听 onFirstVideoFrameDecoded 回调。

参数

uid	用户 ID，指定是哪个用户的视频流。
width	视频流宽（px）。
height	视频流高（px）。

◆ onLastmileProbeResult()

virtual void nertc::IRtcEngineEventHandlerEx::onLastmileProbeResult ( const NERtcLastmileProbeResult & result )

inlinevirtual

通话前网络上下行 Last mile 质量探测报告回调。
该回调描述本地用户在加入房间前的 last mile 网络探测详细报告，报告中通过客观数据反馈上下行网络质量，包括网络抖动、丢包率等数据。您可以通过该回调客观预测本地用户在音视频通话中的网络状态。
在调用 startLastmileProbeTest 之后，SDK 会在约 30 秒内返回该回调。

自从: V4.5.0

参数

result 上下行 Last mile 质量探测结果。

◆ onLastmileQuality()

virtual void nertc::IRtcEngineEventHandlerEx::onLastmileQuality ( NERtcNetworkQualityType quality )

inlinevirtual

通话前网络上下行 last mile 质量状态回调。
该回调描述本地用户在加入房间前的 last mile 网络探测的结果，以打分形式描述上下行网络质量的主观体验，您可以通过该回调预估本地用户在音视频通话中的网络体验。
在调用 startLastmileProbeTest 之后，SDK 会在约 5 秒内返回该回调。

自从: V4.5.0

参数

quality 网络上下行质量，基于上下行网络的丢包率和抖动计算，探测结果主要反映上行网络的状态。

◆ onLiveStreamState()

virtual void nertc::IRtcEngineEventHandlerEx::onLiveStreamState	(	const char *	task_id,
		const char *	url,
		NERtcLiveStreamStateCode	state
	)

inlinevirtual

通知直播推流状态

注解: 该回调在通话中有效。

参数

task_id	任务id
url	推流地址
state	NERtcLiveStreamStateCode, 直播推流状态 505: 推流中； 506: 推流失败； 511: 推流结束；

◆ onLocalAudioVolumeIndication() [1/2]

virtual void nertc::IRtcEngineEventHandlerEx::onLocalAudioVolumeIndication ( int volume )

inlinevirtual

弃用:

该回调方法已废弃。提示房间内本地用户瞬时音量的回调。

该回调默认禁用。可以通过 enableAudioVolumeIndication 方法开启。
开启后，本地用户说话，SDK 会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。
如果本地用户将自己静音（调用了 muteLocalAudioStream），SDK 将音量设置为 0 后回调给应用层。

参数

volume （混音后的）音量，取值范围为 [0,100]。

◆ onLocalAudioVolumeIndication() [2/2]

virtual void nertc::IRtcEngineEventHandlerEx::onLocalAudioVolumeIndication	(	int	volume,
		bool	enable_vad
	)

inlinevirtual

提示房间内本地用户瞬时音量的回调。

该回调默认禁用。可以通过 enableAudioVolumeIndication 方法开启。
开启后，本地用户说话，SDK 会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。
如果本地用户将自己静音（调用了 muteLocalAudioStream），SDK 将音量设置为 0 后回调给应用层。
参数

volume （混音后的）音量，取值范围为 [0,100]。

enable_vad 是否检测到人声。

◆ onLocalPublishFallbackToAudioOnly()

virtual void nertc::IRtcEngineEventHandlerEx::onLocalPublishFallbackToAudioOnly	(	bool	is_fallback,
		NERtcVideoStreamType	stream_type
	)

inlinevirtual

本地发布流已回退为音频流、或已恢复为音视频流回调。
如果您调用了设置本地推流回退选项 setLocalPublishFallbackOption 接口，并将 option 设置为 kNERtcStreamFallbackAudioOnly 后，当上行网络环境不理想、本地发布的媒体流回退为音频流时，或当上行网络改善、媒体流恢复为音视频流时，会触发该回调。

自从: V4.3.0

参数

is_fallback	本地发布流已回退或已恢复。 true：由于网络环境不理想，发布的媒体流已回退为音频流。 false：由于网络环境改善，从音频流恢复为音视频流。
stream_type	对应的视频流类型，即主流或辅流。

◆ onLocalVideoWatermarkState()

virtual void nertc::IRtcEngineEventHandlerEx::onLocalVideoWatermarkState	(	NERtcVideoStreamType	videoStreamType,
		NERtcLocalVideoWatermarkState	state
	)

inlinevirtual

本地视频水印生效结果回调。
调用 setLocalVideoWatermarkConfigs 接口启用本地视频水印后，SDK 会触发此回调。

自从: V4.6.10

参数

videoStreamType	对应的视频流类型，即主流或辅流。详细信息请参考 NERtcVideoStreamType。
state	水印状态。详细信息请参考 NERtcLocalVideoWatermarkState。

◆ onMediaRelayEvent()

virtual void nertc::IRtcEngineEventHandlerEx::onMediaRelayEvent	(	NERtcChannelMediaRelayEvent	event,
		const char *	channel_name,
		NERtcErrorCode	error
	)

inlinevirtual

媒体流相关转发事件回调。

自从: V4.3.0

参数

event	当前媒体流转发事件。详细信息请参考 NERtcChannelMediaRelayEvent 。
channel_name	转发的目标房间名。
error	相关错误码。详细信息请参考 NERtcErrorCode 。

◆ onMediaRelayStateChanged()

virtual void nertc::IRtcEngineEventHandlerEx::onMediaRelayStateChanged	(	NERtcChannelMediaRelayState	state,
		const char *	channel_name
	)

inlinevirtual

跨房间媒体流转发状态发生改变回调。

自从: V4.3.0

参数

state	当前跨房间媒体流转发状态。详细信息请参考 NERtcChannelMediaRelayState
channel_name	媒体流转发的目标房间名。

◆ onMediaRightChange()

virtual void nertc::IRtcEngineEventHandlerEx::onMediaRightChange	(	bool	is_audio_banned,
		bool	is_video_banned
	)

inlinevirtual

服务端禁言音视频权限变化回调。

自从: v4.6.0

参数

is_audio_banned	是否禁用音频。 true：禁用音频。 false：取消禁用音频。
is_video_banned	是否禁用视频。 true：禁用视频。 false：取消禁用视频。

◆ onRecvSEIMsg()

virtual void nertc::IRtcEngineEventHandlerEx::onRecvSEIMsg	(	uid_t	uid,
		const char *	data,
		uint32_t	dataSize
	)

inlinevirtual

收到远端流的 SEI 内容回调。
当远端成功发送 SEI 后，本端会收到此回调。

参数

[in]	uid	发送该 sei 的用户 id
[in]	data	接收到的 sei 数据
[in]	dataSize	接收到 sei 数据的大小

◆ onRemoteAudioVolumeIndication()

virtual void nertc::IRtcEngineEventHandlerEx::onRemoteAudioVolumeIndication	(	const NERtcAudioVolumeInfo *	speakers,
		unsigned int	speaker_number,
		int	total_volume
	)

inlinevirtual

提示房间内谁正在说话及说话者瞬时音量的回调。
该回调默认为关闭状态。可以通过 enableAudioVolumeIndication 方法开启。开启后，无论房间内是否有人说话，SDK 都会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。
在返回的 speakers 数组中:

如果有 uid 出现在上次返回的数组中，但不在本次返回的数组中，则默认该 uid 对应的远端用户没有说话。

如果volume 为 0，表示该用户没有说话。

如果speakers 数组为空，则表示此时远端没有人说话。

参数

speakers	每个说话者的用户 ID 和音量信息的数组: NERtcAudioVolumeInfo
speaker_number	speakers 数组的大小，即说话者的人数。
total_volume	（混音后的）总音量，取值范围为 [0,100]。

◆ onRemoteSubscribeFallbackToAudioOnly()

virtual void nertc::IRtcEngineEventHandlerEx::onRemoteSubscribeFallbackToAudioOnly	(	uid_t	uid,
		bool	is_fallback,
		NERtcVideoStreamType	stream_type
	)

inlinevirtual

订阅的远端流已回退为音频流、或已恢复为音视频流回调。
如果你调用了设置远端订阅流回退选项 setRemoteSubscribeFallbackOption 接口并将 option 设置 kNERtcStreamFallbackAudioOnly 后，当下行网络环境不理想、仅接收远端音频流时，或当下行网络改善、恢复订阅音视频流时，会触发该回调。

自从: V4.3.0

参数

uid	远端用户的 ID。
is_fallback	远端订阅流已回退或恢复： true：由于网络环境不理想，订阅的远端流已回退为音频流。 false：由于网络环境改善，订阅的远端流从音频流恢复为音视频流。
stream_type	对应的视频流类型，即主流或辅流。

◆ onRemoveLiveStreamTask()

virtual void nertc::IRtcEngineEventHandlerEx::onRemoveLiveStreamTask	(	const char *	task_id,
		int	error_code
	)

inlinevirtual

通知删除直播任务结果。
该回调异步返回 removeLiveStreamTask 接口的调用结果；实际推流状态参考 onLiveStreamState

参数

task_id	任务id
error_code	结果 0: 调用成功；其他: 调用失败。

◆ onScreenCaptureStatus()

virtual void nertc::IRtcEngineEventHandlerEx::onScreenCaptureStatus ( NERtcScreenCaptureStatus status )

inlinevirtual

屏幕共享状态变化回调。

自从: V4.2.0

注解: macOS 平台自 V4.6.0 支持此回调。

参数

status 屏幕共享状态。详细信息请参考 NERtcScreenCaptureStatus 。

◆ onUpdateLiveStreamTask()

virtual void nertc::IRtcEngineEventHandlerEx::onUpdateLiveStreamTask	(	const char *	task_id,
		const char *	url,
		int	error_code
	)

inlinevirtual

通知更新直播任务结果。该回调异步返回 updateLiveStreamTask 接口的调用结果；实际推流状态参考 onLiveStreamState

参数

task_id	任务id
url	推流地址
error_code	结果 0: 调用成功；其他: 调用失败。

◆ onUserAudioMute()

virtual void nertc::IRtcEngineEventHandlerEx::onUserAudioMute	(	uid_t	uid,
		bool	mute
	)

inlinevirtual

远端用户是否静音的回调。

注解: 该回调由远端用户调用 muteLocalAudioStream 方法开启或关闭音频发送触发。

参数

uid	远端用户ID。
mute	是否静音。

◆ onUserSubStreamAudioMute()

virtual void nertc::IRtcEngineEventHandlerEx::onUserSubStreamAudioMute	(	uid_t	uid,
		bool	mute
	)

inlinevirtual

远端用户暂停或恢复发送音频辅流的回调。

自从: V4.6.10

参数

uid	远端用户ID。
mute	是否停止发送音频辅流。 true：该用户已暂停发送音频辅流。 false：该用户已恢复发送音频辅流。

◆ onUserSubStreamAudioStart()

virtual void nertc::IRtcEngineEventHandlerEx::onUserSubStreamAudioStart ( uid_t uid )

inlinevirtual

远端用户开启音频辅流回调。

自从: V4.6.10

参数

uid 远端用户 ID。

◆ onUserSubStreamAudioStop()

virtual void nertc::IRtcEngineEventHandlerEx::onUserSubStreamAudioStop ( uid_t uid )

inlinevirtual

远端用户停用音频辅流回调。

自从: V4.6.10

参数

uid 远端用户 ID。

◆ onUserSubStreamVideoStart()

virtual void nertc::IRtcEngineEventHandlerEx::onUserSubStreamVideoStart	(	uid_t	uid,
		NERtcVideoProfileType	max_profile
	)

inlinevirtual

远端用户开启屏幕共享辅流通道的回调。

参数

uid	远端用户 ID。
max_profile	最大分辨率。

◆ onUserSubStreamVideoStop()

virtual void nertc::IRtcEngineEventHandlerEx::onUserSubStreamVideoStop ( uid_t uid )

inlinevirtual

远端用户停止屏幕共享辅流通道的回调。

参数

uid 远端用户ID。

◆ onUserVideoMute() [1/2]

virtual void nertc::IRtcEngineEventHandlerEx::onUserVideoMute	(	NERtcVideoStreamType	videoStreamType,
		uid_t	uid,
		bool	mute
	)

inlinevirtual

远端用户暂停或恢复发送视频回调。
当远端用户调用 muteLocalVideoStream 方法取消或者恢复发布视频流时，SDK 会触发该回调向本地用户通知远端用户的发流情况。

自从: V4.6.20

参数说明

参数名称	类型	描述
videoStreamType	NERtcVideoStreamType	视频通道类型： kNERTCVideoStreamMain：主流。 kNERtcVideoStreamSub：辅流。
uid	uid_t	用户 ID，提示是哪个用户的视频流。
mute	bool	是否暂停发送视频流： true：该用户已暂停发送视频流。 false：该用户已恢复发送视频流。

◆ onUserVideoMute() [2/2]

virtual void nertc::IRtcEngineEventHandlerEx::onUserVideoMute	(	uid_t	uid,
		bool	mute
	)

inlinevirtual

远端用户暂停或恢复发送视频流的回调。
当远端用户调用 muteLocalVideoStream 取消或者恢复发布视频流时，SDK会触发该回调向本地用户报告远程用户的发流状况。

注解: 该回调仅在远端用户的视频主流状态改变时会触发，若您希望同时接收到远端用户视频辅流状态变更的通知，请监听 onUserVideoMute 回调。

参数

uid	远端用户ID。
mute	是否暂停发送视频流。 true：该用户已暂停发送视频流。 = false：该用户已恢复发送视频流。

◆ onUserVideoProfileUpdate()

virtual void nertc::IRtcEngineEventHandlerEx::onUserVideoProfileUpdate	(	uid_t	uid,
		NERtcVideoProfileType	max_profile
	)

inlinevirtual

参数

uid	远端用户 ID。
max_profile	视频编码的分辨率，用于衡量编码质量。

◆ onVideoDeviceStateChanged()

virtual void nertc::IRtcEngineEventHandlerEx::onVideoDeviceStateChanged	(	const char	device_id[kNERtcMaxDeviceIDLength],
		NERtcVideoDeviceType	device_type,
		NERtcVideoDeviceState	device_state
	)

inlinevirtual

视频设备状态已改变的回调。

参数

device_id	设备ID。
device_type	视频设备类型。
device_state	视频设备状态。

◆ onVirtualBackgroundSourceEnabled()

virtual void nertc::IRtcEngineEventHandlerEx::onVirtualBackgroundSourceEnabled	(	bool	enabled,
		NERtcVirtualBackgroundSourceStateReason	reason
	)

inlinevirtual

通知虚拟背景功能是否成功启用的回调。
调用 enableVirtualBackground 方法后，SDK 返回此回调通知虚拟背景功能是否成功启用。

自从: V4.6.0

注解: 如果您设置虚拟背景为 PNG 或 JPG 格式的自定义图像，此回调会等到图像被完全读取后才会返回，因此会有一段时间的延迟。

参数

enabled	是否成功启用虚拟背景。 true：成功启用。 false：未成功启用。
reason	虚拟背景功能未成功启用的原因或成功启用虚拟背景功能的通知。详细信息请参考 NERtcVirtualBackgroundSourceStateReason。

该类的文档由以下文件生成:

api/nertc_engine_event_handler_ex.h

state	音乐文件播放状态，详见 NERtcAudioMixingState.
error_code	错误码，详见 NERtcAudioMixingErrorCode.

volume	（混音后的）音量，取值范围为 [0,100]。
enable_vad	是否检测到人声。

Public 成员函数

详细描述

成员函数说明

◆ onAddLiveStreamTask()

◆ onAudioDefaultDeviceChanged()

◆ onAudioDeviceStateChanged()

◆ onAudioEffectFinished()

◆ onAudioHowling()

◆ onAudioMixingStateChanged()

◆ onAudioMixingTimestampUpdate()

◆ onAudioRecording()

◆ onCaptureVideoFrame()

◆ onCheckNECastAudioDriverResult()

◆ onFirstAudioDataReceived()

◆ onFirstAudioFrameDecoded()

◆ onFirstVideoDataReceived() [1/2]

◆ onFirstVideoDataReceived() [2/2]

◆ onFirstVideoFrameDecoded() [1/2]

◆ onFirstVideoFrameDecoded() [2/2]

◆ onLastmileProbeResult()

◆ onLastmileQuality()

◆ onLiveStreamState()

◆ onLocalAudioVolumeIndication() [1/2]

◆ onLocalAudioVolumeIndication() [2/2]

◆ onLocalPublishFallbackToAudioOnly()

◆ onLocalVideoWatermarkState()

◆ onMediaRelayEvent()

◆ onMediaRelayStateChanged()

◆ onMediaRightChange()

◆ onRecvSEIMsg()

◆ onRemoteAudioVolumeIndication()

◆ onRemoteSubscribeFallbackToAudioOnly()

◆ onRemoveLiveStreamTask()

◆ onScreenCaptureStatus()

◆ onUpdateLiveStreamTask()

◆ onUserAudioMute()

◆ onUserSubStreamAudioMute()

◆ onUserSubStreamAudioStart()

◆ onUserSubStreamAudioStop()

◆ onUserSubStreamVideoStart()

◆ onUserSubStreamVideoStop()

◆ onUserVideoMute() [1/2]

◆ onUserVideoMute() [2/2]

◆ onUserVideoProfileUpdate()

◆ onVideoDeviceStateChanged()

◆ onVirtualBackgroundSourceEnabled()