NERtc Windows SDK  V5.3.1
Public 成员函数 | 所有成员列表
nertc::INERtcAudioFrameObserver类 参考abstract

#include <nertc_engine_defines.h>

Public 成员函数

virtual void onAudioFrameDidRecord (NERtcAudioFrame *frame)=0
 
virtual void onSubStreamAudioFrameDidRecord (NERtcAudioFrame *frame)=0
 
virtual void onAudioFrameWillPlayback (NERtcAudioFrame *frame)=0
 
virtual void onMixedAudioFrame (NERtcAudioFrame *frame)=0
 
virtual void onPlaybackAudioFrameBeforeMixing (uint64_t userID, NERtcAudioFrame *frame)=0
 
virtual void onPlaybackAudioFrameBeforeMixing (uint64_t userID, NERtcAudioFrame *frame, channel_id_t cid)=0
 
virtual void onPlaybackSubStreamAudioFrameBeforeMixing (uint64_t userID, NERtcAudioFrame *frame, channel_id_t cid)=0
 

详细描述

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

成员函数说明

◆ onAudioFrameDidRecord()

virtual void nertc::INERtcAudioFrameObserver::onAudioFrameDidRecord ( NERtcAudioFrame frame)
pure virtual

采集音频数据回调,用于声音处理等操作。

注解
  • 返回音频数据支持读/写。
  • 有本地音频数据驱动就会回调。
参数
frame音频帧。

◆ onAudioFrameWillPlayback()

virtual void nertc::INERtcAudioFrameObserver::onAudioFrameWillPlayback ( NERtcAudioFrame frame)
pure virtual

播放音频数据回调,用于声音处理等操作。

注解
  • 返回音频数据支持读/写。
  • 有本地音频数据驱动就会回调。
参数
frame音频帧。

◆ onMixedAudioFrame()

virtual void nertc::INERtcAudioFrameObserver::onMixedAudioFrame ( NERtcAudioFrame frame)
pure virtual

获取本地用户和所有远端用户混音后的原始音频数据。

注解
  • 返回音频数据只读。
  • 有本地音频数据驱动就会回调。
参数
frame音频帧。

◆ onPlaybackAudioFrameBeforeMixing() [1/2]

virtual void nertc::INERtcAudioFrameObserver::onPlaybackAudioFrameBeforeMixing ( uint64_t  userID,
NERtcAudioFrame frame 
)
pure virtual

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

注解
返回音频数据只读。
弃用:
即将废弃,请改用接口 nertc::INERtcAudioFrameObserver::onPlaybackAudioFrameBeforeMixing(uint64_t userID, NERtcAudioFrame* frame, channel_id_t cid) "onPlaybackAudioFrameBeforeMixing"[2/2]。在多房间场景下,此接口可通过 cid 识别不同房间。
参数
userID用户 ID。
frame音频帧。

◆ onPlaybackAudioFrameBeforeMixing() [2/2]

virtual void nertc::INERtcAudioFrameObserver::onPlaybackAudioFrameBeforeMixing ( uint64_t  userID,
NERtcAudioFrame frame,
channel_id_t  cid 
)
pure virtual

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

注解
返回的音频数据只读。
自从
V4.5.0
参数
userID用户 ID。
frame音频帧。
cid房间 ID。在多房间场景下,cid 用于识别不同的房间。

◆ onPlaybackSubStreamAudioFrameBeforeMixing()

virtual void nertc::INERtcAudioFrameObserver::onPlaybackSubStreamAudioFrameBeforeMixing ( uint64_t  userID,
NERtcAudioFrame frame,
channel_id_t  cid 
)
pure virtual

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

注解
返回音频数据只读。
参数
userID用户ID。
frame音频帧。
cid房间 ID。在多房间场景下,cid 用于识别不同的房间。

◆ onSubStreamAudioFrameDidRecord()

virtual void nertc::INERtcAudioFrameObserver::onSubStreamAudioFrameDidRecord ( NERtcAudioFrame frame)
pure virtual

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

业务场景
通过该回调数据可以获取辅流采集数据,也可以通过回调数据做音频前处理(变声、音效处理等)。
自从
V4.6.20
注解
  • 有本地音频辅流据驱动就会返回该回调。
  • 返回音频数据支持读/写。
  • 该接口返回的数据格式,需要以返回数据 NERtcAudioFrame 中的 NERtcAudioFormat 为准。
参数说明
参数名称 类型 描述
frame NERtcAudioFrame 音频帧。包含数据格式及数据内容。

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