NERtc iOS SDK  V5.3.1
构造函数 | 所有成员列表
<NERtcEngineAudioFrameObserver>协议 参考

音频数据回调
如果需要对音频数据做处理,需要实现这个 protocol 更多...

#import <NERtcEngineDelegate.h>

类 <NERtcEngineAudioFrameObserver> 继承关系图:

构造函数

(void) - onNERtcEngineAudioFrameDidRecord:
 采集音频数据回调,用于声音处理等操作。 更多...
 
(void) - onNERtcEngineAudioFrameWillPlayback:
 播放音频数据回调,用于声音处理等操作。 更多...
 
(void) - onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:
 获取某一远端用户混音前的音频数据。
成功注册音频观测器后,如果订阅了远端音频(默认订阅)且远端用户开启音频后,SDK 会在捕捉到混音前的音频数据时,触发该回调,将音频数据回调给用户。 更多...
 
(void) - onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:channelId:
 获取某一远端用户混音前的音频数据。
成功注册音频观测器后,如果订阅了远端音频(默认订阅)且远端用户开启音频后,SDK 会在捕捉到混音前的音频数据时,触发该回调,将音频数据回调给用户。 更多...
 
(void) - onNERtcEngineMixedAudioFrame:
 获取本地用户和所有远端用户混音后的原始音频数据。 更多...
 
(void) - onNERtcEngineSubStreamAudioFrameDidRecord:
 本地音频辅流数据回调,用于自定义音频辅流数据。 更多...
 
(void) - onNERtcEnginePlaybackSubStreamAudioFrameBeforeMixingWithUserID:frame:channelId:
 获取指定远端用户混音前的音频辅流数据。
成功注册音频观测器后,如果订阅了远端音频辅流(默认订阅)且远端用户开启音频辅流后,SDK 会在捕捉到混音前的音频数据时,触发该回调,将音频数据发送给您。 更多...
 

详细描述

音频数据回调
如果需要对音频数据做处理,需要实现这个 protocol

函数文档

◆ onNERtcEngineAudioFrameDidRecord:

- (void) onNERtcEngineAudioFrameDidRecord: (NERtcAudioFrame *)  frame
optional

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

  • 返回音频数据支持读写。
  • 有本地音频数据驱动就会回调。
  • 需要同步返回,engine 将会继续音频处理流程。 允许修改 frame 里 void *data 所指向的内容,不允许修改 format。如果对 format 有要求,请通过setParameter : kNERtcKeyObserveRecordAudioFrameFormat 进行设置。
    参数
    frame音频帧数据,详细信息请参考 NERtcAudioFrame

◆ onNERtcEngineAudioFrameWillPlayback:

- (void) onNERtcEngineAudioFrameWillPlayback: (NERtcAudioFrame *)  frame
optional

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

  • 需要同步返回,engine 将会继续音频处理流程。
  • 返回音频数据支持读写。
  • 有本地音频数据驱动就会回调。
    允许修改 frame 里 void *data 所指向的内容,不允许修改 format。如果对 format 有要求,请通过setParameter : kNERtcKeyObservePlaybackAudioFrameFormat 进行设置。
    参数
    frame音频帧数据,详细信息请参考 NERtcAudioFrame

◆ onNERtcEngineMixedAudioFrame:

- (void) onNERtcEngineMixedAudioFrame: (NERtcAudioFrame *)  frame
optional

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

注解
  • 该回调为只读模式。
  • 返回音频数据只读。
  • 有本地音频数据驱动就会回调。 不支持修改 frame 里 void *data 所指向的内容,不允许修改 format。如果对 format 有要求,请通过setMixedAudioFrameParameters进行设置
参数
frame音频帧数据,详细信息请参考 NERtcAudioFrame

◆ onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:

- (void) onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID: (uint64_t)  userID
frame: (NERtcAudioFrame *)  frame 
optional

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

注解
  • 返回音频数据只读。
  • 不支持修改 frame 里 void *data 所指向的内容,不支持修改 format。
弃用:
即将废弃,请改用接口 NERtcEngineAudioFrameObserver#onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:channelId:。在多房间场景下,此接口可通过 channelId 识别不同房间。
参数
userID远端用户的 ID。
frame音频帧数据,详细信息请参考 NERtcAudioFrame

◆ onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:channelId:

- (void) onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID: (uint64_t)  userID
frame: (NERtcAudioFrame *)  frame
channelId: (uint64_t)  channelId 
optional

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

注解
  • 返回音频数据只读。
  • 不支持修改 frame 里 void *data 所指向的内容,不支持修改 format。
自从
V4.5.0
参数
userID远端用户的 ID。
frame音频帧数据,详细信息请参考 NERtcAudioFrame
channelId房间 ID。在多房间场景下,channelId 用于识别不同的房间。

◆ onNERtcEnginePlaybackSubStreamAudioFrameBeforeMixingWithUserID:frame:channelId:

- (void) onNERtcEnginePlaybackSubStreamAudioFrameBeforeMixingWithUserID: (uint64_t)  userID
frame: (NERtcAudioFrame *)  frame
channelId: (uint64_t)  channelId 
optional

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

注解
  • 返回的音频数据只读。
  • 不支持修改 frame 里 void *data 所指向的内容,不支持修改 format。
参数
userID远端用户的 ID。
framePCM 音频帧数据,详细信息请参考 NERtcAudioFrame
channelId房间 ID。在多房间场景下,channelId 用于识别不同的房间。

◆ onNERtcEngineSubStreamAudioFrameDidRecord:

- (void) onNERtcEngineSubStreamAudioFrameDidRecord: (NERtcAudioFrame *)  frame
optional

本地音频辅流数据回调,用于自定义音频辅流数据。

注解
  • 只要开启辅流,SDK 就会返回此回调。
  • 返回音频数据支持读或写模式,由于该回调一般用于自定义音频辅流数据,建议使用写模式。
  • 允许修改 frame 里 void *data 所指向的内容,不允许修改 format。如果对 format 有要求,请通过 setParameter:kNERtcKeyObserveRecordAudioFrameFormat 进行设置。
参数
frame音频帧数据,详细信息请参考 NERtcAudioFrame

该协议的文档由以下文件生成: