NERtc Android SDK  V5.6.0
简介

网易云信 NERTC SDK 提供完善的音视频通话开发框架,提供基于网络的点对点视频通话和语音通话功能,还提供多人视频和音频会议功能,支持通话中音视频设备控制和实时音视频模式切换,支持视频采集数据回调以实现美颜等自定义功能。

  • NERtc 接口类包含应用程序调用的主要方法。
  • NERtcEx 接口类包含应用程序调用的扩展方法。
  • NERtcCallback 类用于向应用程序发送用户状态回调通知。
  • NERtcCallbackEx 类用于向应用程序发送音视频信息回调通知。
  • channel.NERtcChannel 类在指定房间中实现实时音视频功能。通过创建多个 NERtcChannel 对象,用户可以同时加入多个房间。
  • channel.NERtcChannelCallback 类监听和报告指定房间的事件和数据。

错误码

在调用 SDK API 的过程中,SDK 可能会返回错误码或状态码,您可以根据错误码或状态码判断当前 SDK 或任务的状态。如果遇到未知的错误码,请联系技术支持排查。

当前 SDK API 的错误码如下:

房间管理

方法 功能 起始版本
NERtc#getInstance() 创建 RTC 引擎对象。 V3.5.0
NERtc#init() RTC 引擎对象初始化。 V3.5.0
NERtcEx#setNERtcCallback() 设置事件通知回调。 V4.6.40
NERtc#release() 销毁NERtc实例,释放资源。 V3.5.0
NERtcEx#setChannelProfile() 设置房间场景。 V3.6.0
NERtcEx#setClientRole() 设置用户角色。 V3.9.0
NERtc#joinChannel() 加入房间。 V3.5.0
NERtcEx#switchChannel() 直播场景中快速切换房间。 V4.1.0
NERtc#leaveChannel() 离开房间。 V3.5.0
NERtc#setParameters() 复杂参数设置接口。如果需要设置相关参数,请在调用 init 接口初始化之前调用此接口。 V3.5.0
NERtcEx#getConnectionState() 获取房间连接状态。 V3.5.0
NERtc#updatePermissionKey() 更新权限密钥。 V4.6.29

房间事件

事件 描述 起始版本
NERtcCallback#onClientRoleChange() 用户角色已切换回调。 V3.9.0
NERtcCallback#onJoinChannel() 加入房间回调。 V3.5.0
NERtcCallbackEx#onReJoinChannel() 重新加入房间回调。 V3.5.0
NERtcCallback#onLeaveChannel() 离开房间回调。 V3.5.0
NERtcCallbackEx#onReconnectingStart() 开始重连回调。 V3.7.0
NERtcCallback#onUserJoined(long uid) 远端用户加入当前房间回调。 V3.5.0
NERtcCallback#onUserJoined(long uid, NERtcUserJoinExtraInfo joinExtraInfo) 远端用户加入当前房间回调。 V4.6.29
NERtcCallback#onUserLeave(long uid,int reason) 远端用户离开当前房间回调。 V3.5.0
NERtcCallback#onUserLeave(long uid, int reason, NERtcUserLeaveExtraInfo leaveExtraInfo) 远端用户离开当前房间回调。 V4.6.29
NERtcCallback#onDisconnect() 服务器连接断开回调。 V3.5.0
NERtcCallbackEx#onConnectionTypeChanged() 本地网络类型已改变回调。 V3.5.0
NERtcCallbackEx#onConnectionStateChanged() 房间连接状态已改变回调。 V3.8.0
NERtcCallbackEx#onPermissionKeyWillExpire() 权限密钥即将过期事件回调。 V4.6.29
NERtcCallbackEx#onUpdatePermissionKey() 更新权限密钥事件回调。 V4.6.29

音频管理

方法 功能 起始版本
NERtc#setAudioProfile() 设置音频编码配置 V3.5.0
NERtcEx#adjustRecordingSignalVolume() 调节录音音量 V3.5.0
NERtcEx#adjustPlaybackSignalVolume() 调节播放音量 V3.5.0
NERtcEx#adjustUserPlaybackSignalVolume() 调节本地播放的指定远端用户的信号音量 V4.2.1
NERtc#enableLocalAudio() 开关本地音频采集 V3.5.0
NERtcEx#muteLocalAudioStream() 开关本地音频发送 V3.5.0
NERtc#subscribeRemoteAudioStream() 订阅/取消订阅指定音频流 V3.5.0
NERtc#subscribeAllRemoteAudioStreams() 订阅/取消订阅所有远端音频流 V3.5.0
NERtcEx#setAudioProcessObserver() 注册音频处理观测器,设置音频处理回调 V3.9.0
NERtcEx#setRemoteHighPriorityAudioStream() 设置音频订阅优先级 V4.6.0
NERtcEx#enableLoopbackRecording() 开启或关闭音频共享 V4.6.0
NERtcEx#adjustLoopBackRecordingSignalVolume() 调整音频共享音量 V4.6.0
NERtcEx#enableLocalSubStreamAudio() 开启或关闭音频辅流 V4.6.10
NERtcEx#subscribeRemoteSubStreamAudio() 订阅远端用户辅流 V4.6.10
NERtcEx#muteLocalSubStreamAudio() 静音本地音频辅流 V4.6.10
NERtcEx#setAudioSubscribeOnlyBy() 设置本地用户音频只能被房间内其他指定用户订阅 V4.6.10
NERtcEx#enableMediaPub() 发布或停止发布本地音频 V4.6.10


事件 描述 起始版本
NERtcAudioProcessObserver#onAudioHasHowling() 检测到啸叫回调。 V3.9.0
NERtcAudioFrameObserver#onRecordSubStreamAudioFrame() 本地音频辅流数据回调。 V4.6.10
NERtcAudioFrameObserver#onPlaybackSubStreamAudioFrameBeforeMixingWithUserID() 获取开启音频辅流的远端用户的辅流数据。 V4.6.10

视频管理

方法 功能 起始版本
NERtc#enableLocalVideo(boolean enable) 开启/关闭本地视频的采集与发送 V3.5.0
NERtc#enableLocalVideo(NERtcVideoStreamType streamType, boolean enable) 开启/关闭本地视频的采集与发送 V4.6.20
NERtc#setCameraCaptureConfig(NERtcCameraCaptureConfig captureConfig) 设置本地摄像头的采集偏好等配置 V4.5.0
NERtc#setCameraCaptureConfig(NERtcCameraCaptureConfig captureConfig, NERtcVideoStreamType streamType) 设置本地摄像头的采集偏好等配置 V4.6.20
NERtc#setLocalVideoConfig(NERtcVideoConfig videoConfig) 设置视频编码属性 V3.5.0
NERtc#setLocalVideoConfig(NERtcVideoConfig videoConfig, NERtcVideoStreamType streamType) 设置视频编码属性 V4.6.20
NERtc#setupLocalVideoCanvas() 设置本地用户视图 V3.5.0
NERtc#setupRemoteVideoCanvas() 设置远端用户视图 V3.5.0
NERtc#startVideoPreview() 开启视频预览 V3.5.0
NERtc#startVideoPreview(NERtcVideoStreamType streamType) 开启视频预览 V4.6.20
NERtc#stopVideoPreview() 停止视频预览 V3.5.0
NERtc#stopVideoPreview(NERtcVideoStreamType streamType) 停止视频预览 V4.6.20
NERtcEx#muteLocalVideoStream(boolean mute) 取消/恢复发布本地视频 V3.5.0
NERtcEx#muteLocalVideoStream(NERtcVideoStreamType streamType, boolean mute) 取消/恢复发布本地视频 V4.6.20
NERtc#subscribeRemoteVideoStream() 订阅/取消订阅指定远端用户的视频流 V3.5.0
NERtcVideoView#setScalingType() 设置显示模式 V3.5.0
NERtcEx#postOnGLThread() 将操作设置到具有GLContext的线程中,如销毁第三方滤镜资源 V3.5.0
NERtcEx#enableSuperResolution() 启用或停止 AI 超分 V4.4.0
NERtcEx#enableVideoCorrection() 启用或关闭视频图像畸变矫正 V4.6.0
NERtcEx#setVideoCorrectionConfig() 设置视频图像矫正参数 V4.6.0
NERtcEx#enableVirtualBackground() 开启虚拟背景 V4.6.10

本地媒体事件

事件 描述 起始版本
NERtcCallbackEx#onFirstAudioFrameDecoded() 已解码远端音频首帧的回调 V3.9.0
NERtcCallbackEx#onFirstVideoFrameDecoded(long userID, int width, int height) 已接收到远端视频首帧并完成解码的回调 V3.9.0
NERtcCallbackEx#onFirstVideoFrameDecoded(NERtcVideoStreamType streamType, long userID, int width, int height) 已接收到远端视频首帧并完成解码的回调 V4.6.20
NERtcCallbackEx#onFirstVideoDataReceived(long uid) 已显示远端视频首帧的回调 V3.9.0
NERtcCallbackEx#onFirstVideoDataReceived(NERtcVideoStreamType streamType, long uid) 已显示远端视频首帧的回调 V4.6.20
NERtcCallbackEx#onFirstAudioDataReceived() 远端音频首帧回调 V3.9.0
NERtcCallbackEx#onMediaRightChange() 服务端禁言音视频权限变化回调 V3.9.0
NERtcCallbackEx#onVirtualBackgroundSourceEnabled() 通知虚拟背景是否成功开启的回调 V4.6.10

远端媒体事件

方法 功能 起始版本
NERtcCallbackEx#onUserVideoProfileUpdate() 远端用户更改视频分辨率类型的回调 V3.5.0
NERtcCallbackEx#onUserVideoMute(long uid, boolean muted) 远端用户暂停或恢复发送视频主流的回调 V3.5.0
NERtcCallbackEx#onUserVideoMute(NERtcVideoStreamType streamType, long uid, boolean muted) 远端用户暂停或恢复发送视频主流或辅流的回调 V4.6.20
NERtcCallbackEx#onUserAudioMute() 远端用户暂停或恢复音频主流发送的回调 V3.5.0
NERtcCallbackEx#onUserSubStreamAudioMute() 远端用户暂停或恢复音频辅流发送的回调 V4.6.10
NERtcCallback#onUserAudioStart() 远端用户开启音频主流的回调 V3.5.0
NERtcCallbackEx#onUserSubStreamAudioStart() 远端用户开启音频辅流的回调 V4.6.10
NERtcCallback#onUserAudioStop() 远端用户关闭音频主流的回调 V3.5.0
NERtcCallbackEx#onUserSubStreamAudioStop() 远端用户关闭音频辅流的回调 V4.6.10
NERtcCallback#onUserVideoStart() 远端用户开启视频的回调 V3.5.0
NERtcCallback#onUserVideoStop() 远端用户关闭视频的回调 V3.5.0

数据统计事件

方法 功能 起始版本
NERtcStatsObserver#onRtcStats() 当前通话统计回调,每2秒触发一次 V3.5.0
NERtcStatsObserver#onNetworkQuality() 通话中每个用户的网络上下行质量报告回调 V3.5.0
NERtcStatsObserver#onLocalAudioStats() 本地音频流统计信息回调 V3.5.0
NERtcStatsObserver#onLocalVideoStats() 本地视频流统计信息回调 V3.5.0
NERtcStatsObserver#onRemoteAudioStats() 通话中远端音频流的统计信息回调 V3.5.0
NERtcStatsObserver#onRemoteVideoStats() 通话中远端视频流的统计信息回调 V3.5.0
NERtcEx#setStatsObserver() 设置统计信息回调 V3.5.0

多房间管理

方法 功能 起始版本
NERtcEx#createChannel() 创建并获取一个 NERtcChannel 对象。通过创建多个对象,用户可以同时加入多个房间。 V4.5.0
channel.NERtcChannel 该类提供在指定房间内实现实时音视频功能的方法。 V4.5.0
channel.NERtcChannelCallback 该类提供监听指定房间事件和数据的回调。 V4.5.0

屏幕共享

方法 功能 起始版本
NERtcEx#setupLocalSubStreamVideoCanvas() 设置本端的辅流视频回放画布 V3.9.0
NERtcEx#setupRemoteSubStreamVideoCanvas() 设置远端的辅流视频回放画布 V3.9.0
NERtcEx#startScreenCapture() 开启屏幕共享 V3.5.0
NERtcEx#stopScreenCapture() 停止屏幕共享 V3.5.0
NERtcEx#subscribeRemoteSubStreamVideo() 订阅或取消订阅远端的屏幕共享辅流视频,订阅之后才能接收远端的辅流视频数据 V3.9.0


事件 描述 起始版本
NERtcCallbackEx#onUserSubStreamVideoStart() 远端用户开启屏幕共享辅流通道的回调 V3.9.0
NERtcCallbackEx#onUserSubStreamVideoStop() 远端用户停止屏幕共享辅流通道的回调 V3.9.0

美颜

方法 功能 起始版本
NERtcEx#startBeauty() 开启美颜功能模块 V4.6.10
NERtcEx#stopBeauty() 结束美颜功能模块 V4.6.10
NERtcEx#enableBeauty() 暂停或恢复美颜效果 V4.6.10
NERtcEx#setBeautyEffect() 设置美颜效果 V4.6.10
NERtcEx#addBeautyFilter() 添加滤镜效果 V4.6.10
NERtcEx#removeBeautyFilter() 移除滤镜 V4.6.10
NERtcEx#setBeautyFilterLevel() 设置滤镜强度 V4.6.10

视频大小流

方法 功能 起始版本
NERtcEx#enableDualStreamMode() 设置是否开启视频大小流模式。 V3.5.0

音视频流回退

方法 功能 起始版本
NERtcEx#setLocalPublishFallbackOption() 设置弱网条件下发布的音视频流回退选项。 V4.3.0
NERtcEx#setRemoteSubscribeFallbackOption() 设置弱网条件下订阅的音视频流回退选项。 V4.3.0
NERtcEx#setLocalMediaPriority() 设置本地用户的媒体流优先级。 V4.2.0
事件 描述 起始版本
NERtcCallbackEx#onLocalPublishFallbackToAudioOnly() 本地发布流已回退为音频流或恢复为音视频流回调。 V4.3.0
NERtcCallbackEx#onRemoteSubscribeFallbackToAudioOnly() 远端订阅流已回退为音频流或恢复为音视频流回调。 V4.3.0

通话前网络测试

方法 功能 起始版本
NERtcEx#startLastmileProbeTest() 开始通话前网络质量探测。 V4.5.0
NERtcEx#stopLastmileProbeTest() 停止通话前网络质量探测。 V4.5.0
事件 描述 起始版本
NERtcCallbackEx#onLastmileQuality() 报告本地用户的网络质量。 V4.5.0
NERtcCallbackEx#onLastmileProbeResult() 报告通话前网络上下行 last mile 质量。 V4.5.0

音乐文件播放及混音

方法 功能 起始版本
NERtcEx#startAudioMixing() 开始播放音乐文件 V3.5.0
NERtcEx#stopAudioMixing() 停止播放音乐文件 V3.5.0
NERtcEx#pauseAudioMixing() 暂停播放音乐文件 V3.5.0
NERtcEx#resumeAudioMixing() 恢复播放音乐文件 V3.5.0
NERtcEx#setAudioMixingPlaybackVolume() 设置音乐文件播放音量 V3.5.0
NERtcEx#setAudioMixingSendVolume() 设置音乐文件的发送音量 V3.5.0
NERtcEx#getAudioMixingPlaybackVolume() 获取音乐文件的播放音量 V3.5.0
NERtcEx#getAudioMixingSendVolume() 获取音乐文件的发送音量 V3.5.0
NERtcEx#setAudioMixingPitch() 设置音乐文件的音调 V4.6.29
NERtcEx#getAudioMixingPitch() 获取音乐文件的音调 V4.6.29
NERtcEx#getAudioMixingDuration() 获取音乐文件的总长度 V3.5.0
NERtcEx#setAudioMixingPosition() 设置音乐文件的播放进度 V3.5.0
NERtcEx#getAudioMixingCurrentPosition() 获取音乐文件的播放进度 V3.5.0
事件 描述 起始版本
NERtcCallbackEx#onAudioMixingStateChanged() 本地用户的音乐文件播放状态改变回调 V3.5.0
NERtcCallbackEx#onAudioMixingTimestampUpdate() 本地用户的音乐文件播放进度回调 V3.5.0

音效文件播放管理

方法 功能 起始版本
NERtcEx#getEffectPlaybackVolume() 获取音效文件播放音量。 V3.5.0
NERtcEx#setEffectPlaybackVolume() 设置音效文件播放音量 V3.5.0
NERtcEx#playEffect() 播放指定音效文件 V3.5.0
NERtcEx#stopEffect() 停止播放指定音效文件 V3.5.0
NERtcEx#stopAllEffects() 停止播放所有音效文件 V3.5.0
NERtcEx#pauseEffect() 暂停音效文件播放 V3.5.0
NERtcEx#pauseAllEffects() 暂停所有音效文件播放 V3.5.0
NERtcEx#resumeEffect() 恢复播放指定音效文件 V3.5.0
NERtcEx#resumeAllEffects() 恢复播放所有音效文件 V3.5.0
NERtcEx#setEffectSendVolume() 调节音效文件发送音量 V3.5.0
NERtcEx#getEffectSendVolume() 获取音效文件发送音量 V3.5.0
NERtcEx#setEffectPitch() 设置音效文件音调 V4.6.29
NERtcEx#getEffectPitch() 获取音效文件音调 V4.6.29
NERtcEx#getEffectDuration() 获取音效文件时长 V4.4.0
NERtcEx#setEffectPosition() 设置音效文件的播放进度 V4.6.29
NERtcEx#getEffectCurrentPosition() 获取音效文件的播放进度 V4.4.0
事件 描述 起始版本
NERtcCallbackEx#onAudioEffectFinished() 本地音效文件播放已结束回调 V3.5.0
NERtcCallbackEx#onAudioEffectTimestampUpdate() 本地音效文件的播放进度信息回调 V3.5.0

变声与混响

方法 功能 起始版本
NERtcEx#setAudioEffectPreset() 设置 SDK 预设的人声的变声音效。 V4.1.0
NERtcEx#setVoiceBeautifierPreset() 设置 SDK 预设的美声效果。 V4.0.0
NERtcEx#setLocalVoiceEqualization() 设置本地语音音效均衡,即自定义设置本地人声均衡波段的中心频率。 V4.0.0
NERtcEx#setLocalVoicePitch() 设置本地语音音调。 V4.1.0
NERtcEx#setLocalVoiceReverbParam() 开启本地语音混响效果。 V4.6.10

媒体增强信息

方法 功能 起始版本
NERtcEx#sendSEIMsg() 通过主流通道发送媒体补充增强信息。 V4.0.0
NERtcEx#sendSEIMsg() 发送媒体补充增强信息。通过本接口可指定发送 SEI 时使用主流或辅流通道。 V4.0.0


事件 描述 起始版本
NERtcCallbackEx#onRecvSEIMsg() 收到远端流的 SEI 内容回调。 V4.0.0

旁路推流

注意:该组方法仅适用于互动直播 2.0。

方法 功能 起始版本
NERtcEx#addLiveStreamTask() 添加房间推流任务 V3.5.0
NERtcEx#updateLiveStreamTask() 更新修改房间推流任务 V3.5.0
NERtcEx#removeLiveStreamTask() 删除房间推流任务 V3.5.0


事件 描述 起始版本
NERtcCallbackEx#onLiveStreamState() 直播推流状态回调 V3.5.0

跨房间流媒体转发

方法 功能 起始版本
NERtcEx#startChannelMediaRelay() 开始跨房间媒体流转发。 V4.2.1
NERtcEx#updateChannelMediaRelay() 更新媒体流转发的目标房间。 V4.2.1
NERtcEx#stopChannelMediaRelay() 停止跨房间媒体流转发。 V4.2.1
事件 描述 起始版本
NERtcCallbackEx#onMediaRelayStatesChange() 跨房间媒体流转发状态发生改变回调。 V4.2.1
NERtcCallbackEx#onMediaRelayReceiveEvent() 媒体流相关转发事件回调。 V4.2.1

音量提示

方法 功能 起始版本
NERtcEx#enableAudioVolumeIndication(boolean enable,int interval) 启用说话者音量提示 V3.5.0
NERtcEx#enableAudioVolumeIndication(boolean enable,int interval,boolean enableVad) 启用说话者音量及本地是否有人声提示 V4.6.10
事件 描述 起始版本
NERtcCallbackEx#onRemoteAudioVolumeIndication() 提示房间内谁正在说话及说话者音量的回调 V3.5.0
NERtcCallbackEx#onLocalAudioVolumeIndication(int volume) 提示房间内本地用户瞬时音量的回调 V3.5.0
NERtcCallbackEx#onLocalAudioVolumeIndication(int volume, boolean vadFlag) 提示房间内本地用户瞬时音量及是否存在人声的回调 V4.6.10

耳返

方法 功能 起始版本
NERtcEx#enableEarback() 开启耳返功能 V3.5.0
NERtcEx#setEarbackVolume() 设置耳返音量 V3.5.0

音频播放路由

方法 功能 起始版本
NERtcEx#setSpeakerphoneOn() 设置扬声器是否开启 V3.5.0
NERtcEx#isSpeakerphoneOn() 获取扬声器是否开启 V3.5.0

视频大小流

方法 功能 起始版本
NERtcEx#enableDualStreamMode() 设置是否开启视频大小流模式。 V3.7.0

自定义音频采集与渲染

方法 功能 起始版本
NERtcEx#setExternalAudioSource() 启用外部自定义音频数据主流输入功能,并设置采集参数。 V3.9.0
NERtcEx#setExternalSubStreamAudioSource() 启用外部自定义音频数据辅流输入功能,并设置采集参数。 V4.6.10
NERtcEx#pushExternalAudioFrame() 将外部音频主流数据帧推送给内部引擎。 V3.9.0
NERtcEx#pushExternalSubStreamAudioFrame() 将外部音频辅流数据帧推送给内部引擎。 V4.6.10
NERtcEx#setExternalAudioRender() 设置外部音频渲染。 V4.0.0
NERtcEx#pullExternalAudioFrame() 拉取外部音频数据。 V4.0.0
NERtcEx#setStreamAlignmentProperty() 对齐本地系统时间与服务端时间。 V4.6.10
NERtcEx#getNtpTimeOffset() 获取本地系统时间与服务端时间的差值。 V4.6.10

自定义视频采集

方法 功能 起始版本
NERtcEx#setExternalVideoSource(boolean enable) 开启/关闭外部视频源数据输入 V3.5.0
NERtcEx#setExternalVideoSource(NERtcVideoStreamType streamType, boolean enable) 开启/关闭外部视频源数据输入 V4.6.20
NERtcEx#pushExternalVideoFrame(NERtcVideoFrame frame) 推送外部视频帧 V3.5.0
NERtcEx#pushExternalVideoFrame(NERtcVideoStreamType streamType, NERtcVideoFrame frame) 推送外部视频帧 V4.6.20

音视频裸流传输

方法 功能 起始版本
NERtcEx#setPreDecodeObserver() 注册解码前媒体数据观测器。 V4.6.29
NERtcEx#pushExternalAudioEncodedFrame() 推送外部音频主流编码帧。 V4.6.29
NERtcEx#pushExternalSubStreamAudioEncodedFrame() 推送外部音频辅流编码帧。 V4.6.29
NERtcEx#pushExternalVideoEncodedFrame() 推送外部视频编码帧。 V4.6.29
NERtcEx#setVideoEncoderQosObserver() 注册视频编码 QoS 信息监听器。 V4.6.29
事件 描述 起始版本
predecoder.NERtcPreDecodeObserver#onFrame() 解码前媒体数据回调。 V4.6.29
NERtcVideoEncoderQosObserver#onRequestSendKeyFrame() I 帧请求事件回调。 V4.6.29
NERtcVideoEncoderQosObserver#onVideoCodecUpdated() 视频编码器类型信息回调。 V4.6.29
NERtcVideoEncoderQosObserver#onBitrateUpdated() 码率信息回调。 V4.6.29

原始音频数据

方法 功能 起始版本
NERtcEx#setRecordingAudioFrameParameters() 设置录制的声音格式 V3.5.0
NERtcEx#setPlaybackAudioFrameParameters() 设置播放的声音格式 V3.5.0
NERtcEx#setAudioFrameObserver() 注册语音观测器对象 V3.5.0
NERtcEx#setMixedAudioFrameParameters() 设置采集和播放后的混合后的采样率。需要在加入房间之前调用该接口 V3.9.0
事件 描述 起始版本
NERtcAudioFrameObserver#onRecordFrame() 采集音频数据回调。 V3.5.0
NERtcAudioFrameObserver#onPlaybackFrame() 播放音频数据回调。 V3.5.0
NERtcAudioFrameObserver#onMixedAudioFrame() 音频采集与播放混合后数据帧回调 V3.5.0
NERtcAudioFrameObserver#onPlaybackAudioFrameBeforeMixingWithUserID(long, NERtcAudioFrame) 某一远端用户的原始音频帧回调。
该接口已废弃,请改用 NERtcAudioFrameObserver#onPlaybackAudioFrameBeforeMixingWithUserID(long, NERtcAudioFrame, long)
V3.5.0
NERtcAudioFrameObserver#onPlaybackAudioFrameBeforeMixingWithUserID(long, NERtcAudioFrame, long) 某一远端用户的原始音频帧回调。 V4.5.0

原始视频数据

事件 描述 起始版本
NERtcEx#setVideoCallback() 采集视频数据回调。 V3.5.0
事件 描述 起始版本
NERtcVideoCallback#onVideoCallback() 本地视频数据采集回调 V3.5.0

截图

方法 功能 起始版本
NERtcEx#takeLocalSnapshot() 本地视频画面截图。 V4.2.0
NERtcEx#takeRemoteSnapshot() 远端视频画面截图。 V4.2.0
事件 描述 起始版本
NERtcTakeSnapshotCallback#onTakeSnapshotResult() 截图结果回调。 V4.2.0

水印

方法 功能 起始版本
NERtcEx#setLocalVideoWatermarkConfigs() 添加本地视频水印。 V4.6.10


事件 描述 起始版本
NERtcCallbackEx#onLocalVideoWatermarkState() 水印结果回调。 V4.6.10

加密

方法 功能 起始版本
NERtcEx#enableEncryption() 开启或关闭媒体流加密。 V4.4.0

客户端音频录制

方法 功能 起始版本
NERtcEx#startAudioRecording() 开始客户端录音。 V4.2.0
NERtcEx#startAudioRecordingWithConfig() 开始客户端录音。 V4.6.0
NERtcEx#stopAudioRecording() 停止客户端录音。 V4.2.0
事件 描述 起始版本
NERtcCallbackEx#onAudioRecording() 音频录制状态回调。 V4.2.0

云代理

方法 功能 起始版本
NERtcEx#setCloudProxy() 开启并设置云代理服务。 V4.6.0

设备管理

方法 功能 起始版本
NERtc#checkPermission() 设备权限检查,比如麦克风、摄像头权限 V3.5.0
NERtcEx#switchCamera() 切换前置/后置摄像头 V3.5.0
NERtcEx#switchCameraWithPosition() 指定前置/后置摄像头 V4.6.10
NERtcEx#getCurrentCamera() 查看当前摄像头方向。 V4.5.0
NERtcEx#isCameraZoomSupported() 检测设备是否支持摄像头缩放功能 V3.5.0
NERtcEx#setCameraZoomFactor() 设置摄像头缩放比例 V3.5.0
NERtcEx#getCameraCurrentZoom() 获取当前缩放比例 V3.5.0
NERtcEx#getCameraMaxZoom() 获取摄像头支持的最大视频缩放比例 V3.5.0
NERtcEx#isCameraTorchSupported() 检测设备是否支持闪光灯常开 V3.5.0
NERtcEx#isCameraFocusSupported() 检测设备是否支持手动对焦功能 V3.5.0
NERtcEx#setCameraFocusPosition() 设置当前摄像头聚焦点位置 V3.5.0
NERtcEx#isCameraExposurePositionSupported() 检测设备是否支持手动曝光功能 V3.5.0
NERtcEx#setCameraExposurePosition() 设置手动曝光位置 V3.5.0
NERtcEx#setCameraTorchOn() 设置是否打开闪光灯 V3.5.0
NERtcEx#setPlayoutDeviceMute() 设置音频播放设备的状态 V3.5.0
NERtcEx#isPlayoutDeviceMute() 获取当前音频播放设备是否静音 V3.5.0
NERtcEx#setRecordDeviceMute() 设置录音设备的状态 V3.5.0
NERtcEx#isRecordDeviceMute() 获取当前音频采集设备是否静音 V3.5.0
NERtc#version() NERtc SDK版本号 V3.5.0


方法 功能 起始版本
NERtcCallbackEx#onAudioDeviceChanged() 音频设备状态更改回调 V3.5.0
NERtcCallbackEx#onAudioDeviceStateChange() 音频设备状态切换回调 V3.5.0
NERtcCallbackEx#onVideoDeviceStageChange() 视频设备状态切换回调 V3.5.0
NERtcCallbackEx#onCameraFocusChanged() 摄像头对焦区域已改变回调 V3.5.0
NERtcCallbackEx#onCameraExposureChanged() 摄像头曝光区域已改变回调 V3.5.0

空间音效(3D 音效)和范围语音

方法 功能 起始版本
NERtcEx#initSpatializer() 初始化空间音效 V5.5.10
NERtcEx#enableSpatializer() 开启/关闭空间音效 V5.4.0
NERtcEx#setAudioRecvRange() 设置空间音效的距离衰减属性和语音范围 V5.5.10
NERtcEx#setSpatializerRoomProperty() 设置房间混响属性 V5.4.0
NERtcEx#enableSpatializerRoomEffects() 开启或关闭空间音效的房间混响效果 V5.4.0
NERtcEx#updateSelfPosition() 设置说话者和接收者的位置信息 V5.4.0
NERtcEx#setSpatializerRenderMode() 设置渲染模式 V5.4.0
NERtcEx#setRangeAudioTeamID() 设置范围语音的队伍号 V5.5.10
NERtcEx#setRangeAudioMode() 设置范围语音的模式 V5.5.10
NERtcEx#setSubscribeAudioAllowlist() 设置只订阅指定用户的音频流 V5.5.10
NERtcEx#setSubscribeAudioBlocklist() 设置不订阅指定用户的音频流 V5.5.10

故障排查

方法 功能 起始版本
NERtcEx#uploadSdkInfo() 上传SDK日志信息 V3.5.0
NERtcEx#startAudioDump() 开始记录音频 dump V3.5.0
NERtcEx#stopAudioDump() 结束记录音频 dump V3.5.0


事件 描述 起始版本
NERtcCallbackEx#onWarning() 发生警告回调 V3.5.0
NERtcCallbackEx#onError() 引擎发生了运行时的错误,需要用户干预 V3.5.0