NERTC iOS SDK V5.9.20
载入中...
搜索中...
未找到
实例方法 | 所有成员列表
<NERtcEngineAudioFrameObserver>协议 参考

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

#include <NERtcEngineDelegate.h>

类 <NERtcEngineAudioFrameObserver> 继承关系图:

实例方法

(void) - onNERtcEngineAudioFrameDidRecord:
 采集音频数据回调，用于声音处理等操作。
 
(void) - onNERtcEngineAudioFrameWillPlayback:
 播放音频数据回调，用于声音处理等操作。
 
(void) - onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:
 获取某一远端用户混音前的音频数据。
成功注册音频观测器后，如果订阅了远端音频（默认订阅）且远端用户开启音频后，SDK 会在捕捉到混音前的音频数据时，触发该回调，将音频数据回调给用户。
 
(void) - onNERtcEnginePlaybackAudioFrameBeforeMixingForPlayStreaming: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
optionalrequired

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

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

◆ onNERtcEngineMixedAudioFrame:

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

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

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

◆ onNERtcEnginePlaybackAudioFrameBeforeMixingForPlayStreaming:frame:

- (void) onNERtcEnginePlaybackAudioFrameBeforeMixingForPlayStreaming: (NSString *) playStreamId
frame: (NERtcAudioFrame *) frame 
optionalrequired

获取某一路拉流混音前的音频数据。
成功注册音频观测器后，如果拉流开启了音频，SDK 会在捕捉到混音前的音频数据时，触发该回调，将音频数据回调给用户。

注解
  • 返回音频数据只读。
  • 不支持修改 frame 里 void *data 所指向的内容，不支持修改 format。
参数
playStreamId直播拉流的流ID。
frame音频帧数据，详细信息请参考 NERtcAudioFrame。

◆ onNERtcEnginePlaybackAudioFrameBeforeMixingWithUserID:frame:

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

获取某一远端用户混音前的音频数据。
成功注册音频观测器后，如果订阅了远端音频（默认订阅）且远端用户开启音频后，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 
optionalrequired

获取某一远端用户混音前的音频数据。
成功注册音频观测器后，如果订阅了远端音频（默认订阅）且远端用户开启音频后，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 
optionalrequired

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

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

◆ onNERtcEngineSubStreamAudioFrameDidRecord:

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

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

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