NERtcEngineDelegateEx Protocol Reference

Overview

NERtcEngine 扩展回调

– onNERtcEngineUserVideoProfileDidUpdate:maxProfile:

其他用户更改视频分辨率类型的回调

- (void)onNERtcEngineUserVideoProfileDidUpdate:(uint64_t)userID maxProfile:(NERtcVideoProfileType)maxProfile

Parameters

userID

userID

maxProfile

最大视频分辨率类型

Discussion

其他用户更改视频分辨率类型的回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcEngineUser:videoMuted:

其他用户静音视频发送的回调

- (void)onNERtcEngineUser:(uint64_t)userID videoMuted:(BOOL)muted

Parameters

userID

userID

muted

是否静音

Discussion

其他用户静音视频发送的回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcEngineUser:audioMuted:

其他用户静音音频发送的回调

- (void)onNERtcEngineUser:(uint64_t)userID audioMuted:(BOOL)muted

Parameters

userID

userID

muted

是否静音

Discussion

其他用户静音音频发送的回调

Declared In

NERtcEngineDelegate.h

– onNERtcEngineFirstVideoDataDidReceiveWithUserID:

初次收到某用户的视频数据回调

- (void)onNERtcEngineFirstVideoDataDidReceiveWithUserID:(uint64_t)userID

Parameters

userID

userID

Discussion

初次收到某用户的视频数据回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcEngineFirstAudioDataDidReceiveWithUserID:

初次收到某用户的音频数据回调

- (void)onNERtcEngineFirstAudioDataDidReceiveWithUserID:(uint64_t)userID

Parameters

userID

userID

Discussion

初次收到某用户的音频数据回调

Declared In

NERtcEngineDelegate.h

– onEngineFirstAudioFrameDecoded:

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

- (void)onEngineFirstAudioFrameDecoded:(uint64_t)userID

Parameters

userID

用户 ID,指定是哪个用户的音频流

Discussion

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

Declared In

NERtcEngineDelegate.h

– onEngineFirstVideoFrameDecoded:width:height:

已解码远端视频首帧的回调

- (void)onEngineFirstVideoFrameDecoded:(uint64_t)userID width:(uint32_t)width height:(uint32_t)height

Parameters

userID

用户 ID,指定是哪个用户的视频流

width

视频流宽(px)

height

视频流高(px)

Discussion

已解码远端视频首帧的回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcEngineAudioDeviceStateChangeWithDeviceID:deviceType:deviceState:

音频设备状态切换回调

- (void)onNERtcEngineAudioDeviceStateChangeWithDeviceID:(NSString *)deviceID deviceType:(NERtcAudioDeviceType)deviceType deviceState:(NERtcAudioDeviceState)deviceState

Parameters

deviceID

设备ID

deviceType

设备类型,详见 NERtcAudioDeviceType

deviceState

设备状态,详见 NERtcAudioDeviceState

Discussion

音频设备状态切换回调

Declared In

NERtcEngineDelegate.h

– onNERtcEngineVideoDeviceStateChangeWithDeviceID:deviceType:deviceState:

视频设备状态切换回调

- (void)onNERtcEngineVideoDeviceStateChangeWithDeviceID:(NSString *)deviceID deviceType:(NERtcVideoDeviceType)deviceType deviceState:(NERtcVideoDeviceState)deviceState

Parameters

deviceID

设备ID

deviceType

设备类型,详见 NERtcVideoDeviceType

deviceState

设备状态,详见 NERtcVideoDeviceState

Discussion

视频设备状态切换回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcEngineNetworkConnectionTypeChanged:

网络连接状态变化回调

- (void)onNERtcEngineNetworkConnectionTypeChanged:(NERtcNetworkConnectionType)newConnectionType

Parameters

newConnectionType

新的网络连接类型

Discussion

网络连接状态变化回调

Declared In

NERtcEngineDelegate.h

– onAudioMixingStateChanged:errorCode:

本地用户的音乐文件播放状态改变回调。

- (void)onAudioMixingStateChanged:(NERtcAudioMixingState)state errorCode:(NERtcAudioMixingErrorCode)errorCode

Parameters

state

音乐文件播放状态,详见 #NERtcAudioMixingState.

errorCode

错误码,详见 #NERtcAudioMixingErrorCode.

Discussion

本地用户的音乐文件播放状态改变回调。

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

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

Declared In

NERtcEngineDelegate.h

– onAudioMixingTimestampUpdate:

伴音任务播放进度回调

- (void)onAudioMixingTimestampUpdate:(uint64_t)timeStampMS

Parameters

timeStampMS

当前播放位置

Discussion

伴音任务播放进度回调

Declared In

NERtcEngineDelegate.h

– onLocalAudioVolumeIndication:

提示频道内本地用户瞬时音量的回调。

- (void)onLocalAudioVolumeIndication:(int)volume

Parameters

volume

(混音后的)音量,取值范围为 [0, 100]。

Discussion

提示频道内本地用户瞬时音量的回调。

该回调默认禁用。可以通过 enableAudioVolumeIndication 方法开启; 开启后,本地用户说话,SDK 会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。 如果本地用户将自己静音(调用了 muteLocalAudio),回调的音量将为0。

Declared In

NERtcEngineDelegate.h

– onRemoteAudioVolumeIndication:totalVolume:

提示频道内谁正在说话及说话者音量的回调。

- (void)onRemoteAudioVolumeIndication:(nullable NSArray<NERtcAudioVolumeInfo*> *)speakers totalVolume:(int)totalVolume

Parameters

speakers

每个说话者的用户 ID 和音量信息的数组: NERtcAudioVolumeInfo

totalVolume

(混音后的)总音量,取值范围为 [0, 100]。

Discussion

提示频道内谁正在说话及说话者音量的回调。

该回调默认禁用。可以通过 enableAudioVolumeIndication 方法开启; 开启后,无论频道内是否有人说话,SDK 都会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。

在返回的 speakers 数组中: - 如果有 uid 出现在上次返回的数组中,但不在本次返回的数组中,则默认该 uid 对应的远端用户没有说话。 - 如果volume 为 0,表示该用户没有说话。 - 如果speakers 数组为空,则表示此时远端没有人说话。

Declared In

NERtcEngineDelegate.h

– onNERtcEngineHardwareResourceReleased:

硬件资源已经释放的回调 如果回调结果成功,则意味着 SDK 已经完全释放了硬件资源 用户可以在收到回调成功后重新配置或者使用硬件资源:如设置 AVAudioSession 的配置等等

- (void)onNERtcEngineHardwareResourceReleased:(NERtcError)result

Parameters

result

释放的结果

Discussion

硬件资源已经释放的回调 如果回调结果成功,则意味着 SDK 已经完全释放了硬件资源 用户可以在收到回调成功后重新配置或者使用硬件资源:如设置 AVAudioSession 的配置等等

Declared In

NERtcEngineDelegate.h

– onNERtcCameraFocusChanged:

当前开启摄像头焦点位置变化回调

- (void)onNERtcCameraFocusChanged:(CGPoint)focusPoint

Parameters

focusPoint

新的焦点位置

Discussion

当前开启摄像头焦点位置变化回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcCameraExposureChanged:

当前开启摄像头曝光位置变化回调

- (void)onNERtcCameraExposureChanged:(CGPoint)exposurePoint

Parameters

exposurePoint

新的曝光位置

Discussion

当前开启摄像头曝光位置变化回调

Note: 纯音频SDK禁用该接口,如需使用请前往云信官网下载并替换成视频SDK

Declared In

NERtcEngineDelegate.h

– onNERtcEngineAudioHasHowling

啸叫检测回调 用于检测是否由于设备距离过近产生啸叫。 当检测到有啸叫信号产生的时候,触发该回调一直到啸叫停止 上层用户接收到回调信息,代表有啸叫产生,用户可提示用户mute麦克风或者是直接操作mute麦克风 啸叫检测用于voip场景,音乐场景不支持啸叫检测

- (void)onNERtcEngineAudioHasHowling

Discussion

啸叫检测回调 用于检测是否由于设备距离过近产生啸叫。 当检测到有啸叫信号产生的时候,触发该回调一直到啸叫停止 上层用户接收到回调信息,代表有啸叫产生,用户可提示用户mute麦克风或者是直接操作mute麦克风 啸叫检测用于voip场景,音乐场景不支持啸叫检测

Declared In

NERtcEngineDelegate.h