nertc.IAudioFrameObserver接口 参考

Public 成员函数
void	OnAudioFrameDidRecord (RtcAudioFrame frame)
void	OnSubstreamAudioFrameDidRecord (RtcAudioFrame frame)
void	OnAudioFrameWillPlayback (RtcAudioFrame frame)
void	OnMixedAudioFrame (RtcAudioFrame frame)
void	OnPlaybackAudioFrameBeforeMixing (ulong userId, RtcAudioFrame frame, ulong cid)
void	OnSubstreamPlaybackAudioFrameBeforeMixing (ulong userId, RtcAudioFrame frame, ulong cid)

详细描述

语音观测器对象。
部分接口允许修改 frame 里 data 所指向的内容，但不允许修改 format。如果对 format 有要求，需调用相应设置接口。

成员函数说明

OnAudioFrameDidRecord()

void nertc.IAudioFrameObserver.OnAudioFrameDidRecord

(

RtcAudioFrame

frame

)

采集音频数据回调。

注解

• 返回音频数据支持读/写
• 有本地音频数据驱动就会回调

参数

frame

音频帧。

OnSubstreamAudioFrameDidRecord()

void nertc.IAudioFrameObserver.OnSubstreamAudioFrameDidRecord

(

RtcAudioFrame

frame

)

辅流采集音频数据回调。
通过 SetAudioFrameObserver 接口设置回调监听，当辅流设备工作时，会触发该回调。此外您可以通过 SetRecordingAudioFrameParameters 接口设置回调数据格式。

业务场景

通过该回调数据可以获取辅流采集数据，也可以通过回调数据做音频前处理（变声、音效处理等）。

自从

V4.6.20

注解

• 有本地音频辅流据驱动就会返回该回调。
  
• 返回音频数据支持读/写。
• 该接口返回的数据格式，需要以返回数据 RtcAudioFrame 中的 RtcAudioFormat 为准。

参数说明

参数名称	类型	描述
frame	RtcAudioFrame	音频帧。包含数据格式及数据内容。

OnAudioFrameWillPlayback()

void nertc.IAudioFrameObserver.OnAudioFrameWillPlayback

(

RtcAudioFrame

frame

)

播放音频数据回调。

注解

• 返回音频数据支持读/写
• 有本地音频数据驱动就会回调

参数

frame

音频帧。

OnMixedAudioFrame()

void nertc.IAudioFrameObserver.OnMixedAudioFrame

(

RtcAudioFrame

frame

)

混合采集后的音频数据回调。

注解

• 返回音频数据只读
• 有本地音频数据驱动就会回调

参数

frame

音频帧。

OnPlaybackAudioFrameBeforeMixing()

void nertc.IAudioFrameObserver.OnPlaybackAudioFrameBeforeMixing	(	ulong	userId,
		RtcAudioFrame	frame,
		ulong	cid
	)

获取单个远端用户混音前的音频数据。
成功注册音频观测器后，如果订阅了远端音频（默认订阅）且远端用户开启音频后，SDK会在捕捉到混音前的音频数据时，触发该回调，将音频数据回调给用户。

注解

返回的音频数据只读。

自从

V4.5.0

参数

userID	用户 ID。
frame	音频帧。
cid	房间 ID。在多房间场景下，cid 用于识别不同的房间。

OnSubstreamPlaybackAudioFrameBeforeMixing()

void nertc.IAudioFrameObserver.OnSubstreamPlaybackAudioFrameBeforeMixing	(	ulong	userId,
		RtcAudioFrame	frame,
		ulong	cid
	)

获取指定远端用户混音前的辅流音频数据。
成功注册音频观测器后，如果订阅了远端辅流音频（默认订阅）且远端用户开启辅流音频后，SDK 会在捕捉到混音前的辅流音频数据时，触发该回调，将辅流音频数据回调给用户。

注解

返回音频数据只读。

参数

userID	用户ID。
frame	音频帧。
cid	房间 ID。在多房间场景下，cid 用于识别不同的房间。

---

该接口的文档由以下文件生成:

• AudioFrameObserver.cs