NERTC Android SDK V5.9.20
载入中...
搜索中...
未找到
Public 成员函数 | 所有成员列表
com.netease.lava.nertc.sdk.NERtcCallbackEx接口 参考
类 com.netease.lava.nertc.sdk.NERtcCallbackEx 继承关系图:
com.netease.lava.nertc.sdk.NERtcCallback com.netease.lava.nertc.sdk.AbsNERtcCallbackEx

Public 成员函数

void onUserSubStreamVideoStart (long uid, int maxProfile)
 
void onUserSubStreamVideoStop (long uid)
 
void onUserAudioMute (long uid, boolean muted)
 
void onUserVideoMute (long uid, boolean muted)
 
void onUserVideoMute (NERtcVideoStreamType streamType, long uid, boolean muted)
 
void onUserVideoStart (long uid, NERtcVideoStreamType streamType, int maxProfile)
 
void onUserVideoStop (long uid, NERtcVideoStreamType streamType)
 
void onFirstAudioDataReceived (long uid)
 
void onLocalAudioFirstPacketSent (NERtcAudioStreamType audioStreamType)
 
void onFirstVideoDataReceived (long uid)
 
void onFirstVideoDataReceived (NERtcVideoStreamType streamType, long uid)
 
void onFirstAudioFrameDecoded (long userID)
 
void onFirstVideoFrameDecoded (long userID, int width, int height)
 
void onFirstVideoFrameRender (long userID, NERtcVideoStreamType streamType, int width, int height, long elapsedTime)
 
void onFirstVideoFrameDecoded (NERtcVideoStreamType streamType, long userID, int width, int height)
 
void onUserVideoProfileUpdate (long uid, int maxProfile)
 
void onAudioDeviceChanged (final int selected)
 
void onAudioDeviceStateChange (int deviceType, int deviceState)
 
void onVideoDeviceStageChange (int deviceState)
 
void onConnectionTypeChanged (int newConnectionType)
 
void onReconnectingStart ()
 
void onReJoinChannel (int result, long channelId)
 
void onAudioMixingStateChanged (int reason)
 
void onAudioMixingTimestampUpdate (long timestampMs)
 
void onAudioEffectTimestampUpdate (long id, long timestampMs)
 
void onAudioEffectFinished (int effectId)
 
void onLocalAudioVolumeIndication (int volume)
 
void onLocalAudioVolumeIndication (int volume, boolean vadFlag)
 
void onRemoteAudioVolumeIndication (NERtcAudioVolumeInfo[] volumeArray, int totalVolume)
 
void onLiveStreamState (String taskId, String pushUrl, int liveState)
 
void onConnectionStateChanged (int state, int reason)
 
void onCameraFocusChanged (Rect rect)
 
void onCameraExposureChanged (Rect rect)
 
void onRecvSEIMsg (long userID, String seiMsg)
 
void onAudioRecording (int code, String filePath)
 
void onError (int code)
 
void onWarning (int code)
 
void onApiCallExecuted (String apiName, int result, String message)
 
void onMediaRelayStatesChange (int state, String channelName)
 
void onMediaRelayReceiveEvent (int event, int code, String channelName)
 
void onAsrCaptionStateChanged (int asrState, int code, String message)
 
void onAsrCaptionResult (NERtcAsrCaptionResult[] result, int resultCount)
 
void onPlayStreamingStateChange (String streamId, int state, int reason)
 
void onPlayStreamingReceiveSeiMessage (String streamId, String message)
 
void onPlayStreamingFirstAudioFramePlayed (String streamId, long timeMs)
 
void onPlayStreamingFirstVideoFrameRender (String streamId, long timeMs, int width, int height)
 
void onPlayStreamingDuration (String streamId, long totalDurationS, long currentPtsS)
 
void onLocalPublishFallbackToAudioOnly (boolean isFallback, NERtcVideoStreamType streamType)
 
void onRemoteSubscribeFallbackToAudioOnly (long uid, boolean isFallback, NERtcVideoStreamType streamType)
 
void onLastmileQuality (int quality)
 
void onLastmileProbeResult (LastmileProbeResult result)
 
void onMediaRightChange (boolean isAudioBannedByServer, boolean isVideoBannedByServer)
 
void onRemoteVideoSizeChanged (long userId, NERtcVideoStreamType videoType, int width, int height)
 
void onLocalVideoRenderSizeChanged (NERtcVideoStreamType videoType, int width, int height)
 
void onVirtualBackgroundSourceEnabled (boolean enabled, int reason)
 
void onUserSubStreamAudioStart (long uid)
 
void onUserSubStreamAudioStop (long uid)
 
void onUserSubStreamAudioMute (long uid, boolean muted)
 
void onPermissionKeyWillExpire ()
 
void onUpdatePermissionKey (String key, int error, int timeout)
 
void onLocalVideoWatermarkState (NERtcVideoStreamType videoStreamType, int state)
 
void onUserDataStart (long uid)
 
void onUserDataStop (long uid)
 
void onUserDataReceiveMessage (long uid, ByteBuffer bufferData, long bufferSize)
 
void onUserDataStateChanged (long uid)
 
void onUserDataBufferedAmountChanged (long uid, long previousAmount)
 
void onLabFeatureCallback (String key, Object param)
 
void onAiData (String type, String data)
 
default void onStartPushStreaming (int result, long channelId)
 
default void onStopPushStreaming (int result)
 
default void onPushStreamingReconnecting (int reason)
 
default void onPushStreamingReconnectedSuccess ()
 
- Public 成员函数 继承自 com.netease.lava.nertc.sdk.NERtcCallback
void onJoinChannel (int result, long channelId, long elapsed, long uid)
 
void onLeaveChannel (int result)
 
void onUserJoined (long uid)
 
void onUserJoined (long uid, NERtcUserJoinExtraInfo joinExtraInfo)
 
void onUserLeave (long uid, int reason)
 
void onUserLeave (long uid, int reason, NERtcUserLeaveExtraInfo leaveExtraInfo)
 
void onUserAudioStart (long uid)
 
void onUserAudioStop (long uid)
 
void onUserVideoStart (long uid, int maxProfile)
 
void onUserVideoStop (long uid)
 
void onDisconnect (int reason)
 
void onClientRoleChange (int oldRole, int newRole)
 

详细描述

NERtcCallbackEx

成员函数说明

◆ onAiData()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAiData ( String type,
String data )

AI功能回调接口。

参数
type数据类型
data数据

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAsrCaptionResult()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAsrCaptionResult ( NERtcAsrCaptionResult[] result,
int resultCount )

实时字幕状态回调。

触发时机
当调用 startASRCaption 成功后，有字幕信息时回调。
自从
V5.6.50
参数说明
参数名称 类型 描述
results NERtcAsrCaptionResult 详细的字幕信息数组，详细信息请参考 NERtcAsrCaptionResult。
参数名称 类型 描述
result_count unsigned int 字幕信息数组的个数。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAsrCaptionStateChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAsrCaptionStateChanged ( int asrState,
int code,
String message )

实时字幕状态回调。

触发时机
当调用 startASRCaption 或者 stopASRCaption 成功后，会收到 onAsrCaptionStateChanged 回调。
自从
V5.6.50
参数说明
参数名称 类型 描述
state NERtcAsrCaptionState asr caption 的状态，详细信息请参考 NERtcConstants.AsrCaptionState。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioDeviceChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioDeviceChanged ( final int selected)

语音播放设备已改变回调。

参数
selected选择的设备，详细信息请参考 NERtcConstants.AudioDevice。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioDeviceStateChange()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioDeviceStateChange ( int deviceType,
int deviceState )

音频设备状态已改变回调。

参数
deviceType设备类型。详细信息请参考 NERtcConstants.AudioDeviceType。
deviceState设备状态。详细信息请参考 NERtcConstants.AudioDeviceState。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioEffectFinished()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioEffectFinished ( int effectId)


本地音效文件播放已结束回调。

参数
effectId指定音效的 ID。每个音效均有唯一的 ID

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioEffectTimestampUpdate()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioEffectTimestampUpdate ( long id,
long timestampMs )

本地用户的指定音效文件播放进度回调。

  • 调用 NERtcEx#playEffect() 方法播放音效文件后，SDK 会触发该回调，默认每 1s 返回一次。
    自从
    V4.6.29
    使用前提
    请在 NERtcImpl 接口类中通过 NERtc#init() 接口设置回调监听。
    参数说明
    参数名称 类型 描述
    id long 指定音效文件的 ID。每个音效均有唯一的 ID。
    timestampMs long 指定音效文件的当前播放进度。单位为毫秒。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioMixingStateChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioMixingStateChanged ( int reason)

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

参数
reasonNERtcConstants.AudioMixingError#AUDIO_MIXING_FINISH 表示正常结束；其他状态码表示播放失败，详细信息请参考 NERtcConstants.AudioMixingError。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioMixingTimestampUpdate()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioMixingTimestampUpdate ( long timestampMs)

本地用户的音乐文件播放进度回调。
调用 startAudioMixing 播放混音音乐文件后，当音乐文件的播放进度改变时，会触发该回调。

参数
timestampMs音乐文件播放进度，单位为毫秒。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onAudioRecording()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onAudioRecording ( int code,
String filePath )

音频录制状态回调。

参数
code音频录制状态码。详细信息请参考 NERtcConstants.AudioRecordingCode。
filePath音频录制文件保存路径。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onCameraExposureChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onCameraExposureChanged ( Rect rect)

摄像头曝光区域已改变回调。
该回调是由本地用户调用 setCameraExposurePosition 方法改变曝光位置触发的。

参数
rect新的曝光区域位置。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onCameraFocusChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onCameraFocusChanged ( Rect rect)

摄像头对焦区域已改变回调。
该回调表示相机的对焦区域发生了改变。
该回调是由本地用户调用 setCameraFocusPosition 方法改变对焦位置触发的。

参数
rect新的对焦区域位置。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onConnectionStateChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onConnectionStateChanged ( int state,
int reason )

房间连接状态已改变回调。
该回调在房间连接状态发生改变的时候触发，并告知用户当前的房间连接状态和引起房间状态改变的原因。

参数
state当前的房间连接状态。详细信息请参考 NERtcConstants.ConnectionState。
reason引起当前房间连接状态发生改变的原因。详细信息请参考 NERtcConstants.ConnectionStateChangeReason。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onConnectionTypeChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onConnectionTypeChanged ( int newConnectionType)

本地网络类型已改变回调。
本地网络连接类型发生改变时，SDK 会触发该回调，并在回调中声明当前正在使用的网络连接类型。

参数
newConnectionType当前的本地网络类型，详细信息请参考 NERtcConstants.ConnectionType。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onError()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onError ( int code)

发生错误回调。
该回调方法表示 SDK 运行时出现了网络或媒体相关的错误。
通常情况下，SDK 上报的错误意味着 SDK 无法自动恢复，需要 App 干预或提示用户。

参数
codeNERtcConstants.RuntimeError

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstAudioDataReceived()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstAudioDataReceived ( long uid)

已接收到远端音频首帧的回调。

参数
uid远端用户 ID，指定是哪个用户的音频流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstAudioFrameDecoded()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstAudioFrameDecoded ( long userID)

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

参数
userID远端用户 ID，指定是哪个用户的音频流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstVideoDataReceived() [1/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstVideoDataReceived ( long uid)

已显示远端视频首帧的回调。
第一帧远端视频显示在视图上时，触发此回调。

注解
该回调仅在显示远端用户的主流视频首帧时会触发，若您希望同时接收到接收辅流的相关通知，请监听 NERtcCallbackEx#onFirstVideoDataReceived(NERtcVideoStreamType streamType, long uid) 回调。
参数
uid远端用户 ID，指定是哪个用户的视频流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstVideoDataReceived() [2/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstVideoDataReceived ( NERtcVideoStreamType streamType,
long uid )

已显示远端视频首帧的回调。
当远端视频的第一帧画面显示在视窗上时，会触发此回调。

自从
V4.6.20
参数说明
参数名称 类型 描述
type video.NERtcVideoStreamType 视频通道类型：
  • kNERTCVideoStreamTypeMain：主流。
  • kNERtcVideoStreamTypeSub：辅流。
uid long 用户 ID，提示是哪个用户的视频流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstVideoFrameDecoded() [1/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstVideoFrameDecoded ( long userID,
int width,
int height )

已显示首帧远端视频回调。
引擎收到第一帧远端视频流并解码成功时，触发此调用。 App 可在此回调中设置该用户的视频画布。

注解
该回调仅在接收远端用户的主流视频首帧并完成解码时会触发，若您希望同时接收到接收辅流的相关通知，请监听 NERtcCallbackEx#onFirstVideoFrameDecoded(NERtcVideoStreamType streamType, long userID, int width, int height) 回调。
参数
userID远端用户 ID，指定是哪个用户的视频流。
width首帧视频宽，单位为 px。
height首帧视频高，单位为 px。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstVideoFrameDecoded() [2/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstVideoFrameDecoded ( NERtcVideoStreamType streamType,
long userID,
int width,
int height )

已接收到远端视频首帧并完成解码的回调。
当 SDK 收到远端视频并解码成功时，会触发该回调。应用层可在该回调中设置此用户的视频画布。

自从
V4.6.20
参数说明
参数名称 类型 描述
streamType video.NERtcVideoStreamType 视频通道类型：
  • kNERTCVideoStreamTypeMain：主流。
  • kNERtcVideoStreamTypeSub：辅流。
userID long 用户 ID，提示是哪个用户的视频流。
width int 首帧视频的宽度，单位为 px。
height int 首帧视频的高度，单位为 px。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onFirstVideoFrameRender()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onFirstVideoFrameRender ( long userID,
NERtcVideoStreamType streamType,
int width,
int height,
long elapsedTime )

已接收到远端视频首帧并完成渲染的回调。
当 SDK 收到远端视频的第一帧并渲染成功时，会触发该回调。

参数
userID远端用户 ID，指定是哪个用户的视频流。
streamType视频通道类型，即主流或辅流。
width首帧视频宽，单位为 px。
height首帧视频高，单位为 px。
elapsedTime从订阅动作开始到发生此事件过去的时间（毫秒)。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLabFeatureCallback()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLabFeatureCallback ( String key,
Object param )

一些特定功能回调， 建议空实现。

参数
key功能对应的 key
param回调参数，每个 key 的具体类型不一样，详情请 提交工单 联系网易云信技术支持工程师。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLastmileProbeResult()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLastmileProbeResult ( LastmileProbeResult result)

通话前网络上下行 Last mile 质量探测报告回调。
该回调描述本地用户在加入房间前的 last mile 网络探测详细报告，报告中通过客观数据反馈上下行网络质量，包括网络抖动、丢包率等数据。您可以通过该回调客观预测本地用户在音视频通话中的网络状态。
在调用 startLastmileProbeTest 之后，SDK 会在约 30 秒内返回该回调。

自从
V4.5.0
参数
result上下行 Last mile 质量探测结果。详细信息请参考 LastmileProbeResult。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLastmileQuality()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLastmileQuality ( int quality)

通话前网络上下行 last mile 质量状态回调。
该回调描述本地用户在加入房间前的 last mile 网络探测的结果，以打分形式描述上下行网络质量的主观体验，您可以通过该回调预估本地用户在音视频通话中的网络体验。
在调用 startLastmileProbeTest 之后，SDK 会在约 5 秒内返回该回调。

自从
V4.5.0
参数
quality网络上下行质量，基于上下行网络的丢包率和抖动计算，探测结果主要反映上行网络的状态。详细信息参考 NERtcConstants.NERtcLastmileQuality
  • QUALITY_UNKNOWN(0)：质量未知
  • QUALITY_EXCELLENT(1)：质量极好
  • QUALITY_GOOD(2)：用户主观感觉和极好差不多，但码率可能略低于极好
  • QUALITY_POOR(3)：用户主观感受有瑕疵但不影响沟通
  • QUALITY_BAD(4)：勉强能沟通但不顺畅
  • QUALITY_VBAD(5)：网络质量非常差，基本不能沟通
  • QUALITY_DOWN(6)：完全无法沟通

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLiveStreamState()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLiveStreamState ( String taskId,
String pushUrl,
int liveState )

推流状态已改变回调。

参数
taskId推流任务 ID。
pushUrl推流任务对应的 URL 地址。
liveState推流状态，详细信息请参考 NERtcConstants.LiveStreamState。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLocalAudioFirstPacketSent()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLocalAudioFirstPacketSent ( NERtcAudioStreamType audioStreamType)

发送音频首包回调

参数
audioStreamType音频类型
参见
NERtcAudioStreamType

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLocalAudioVolumeIndication() [1/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLocalAudioVolumeIndication ( int volume)

提示房间内本地用户瞬时音量的回调。
该回调默认为关闭状态。可以通过 enableAudioVolumeIndication 方法开启。开启后，本地用户说话，SDK 会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。

参数
volume混音后的音量，范围为 0~100。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLocalAudioVolumeIndication() [2/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLocalAudioVolumeIndication ( int volume,
boolean vadFlag )

提示房间内本地用户瞬时音量的回调。
该回调默认为关闭状态。可以通过 NERtcEx#enableAudioVolumeIndication(boolean enable, int interval, boolean enableVad) 方法开启；开启后，本地用户说话，SDK 会按该方法中设置的时间间隔触发该回调。
如果本地用户将自己静音（调用了 NERtcEx#muteLocalAudioStream(boolean mute)），SDK 将音量设置为 0 后回调给应用层。

自从
V4.6.10
参数
volume混音后的音量，范围为 0 ~ 100。
vadFlag是否检测到人声。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLocalPublishFallbackToAudioOnly()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLocalPublishFallbackToAudioOnly ( boolean isFallback,
NERtcVideoStreamType streamType )

本地发布流已回退为音频流、或已恢复为音视频流回调。 如果您调用了设置本地推流回退选项 setLocalPublishFallbackOption 接口，并将 option 设置为 AUDIO_ONLY 后，当上行网络环境不理想、本地发布的媒体流回退为音频流时，或当上行网络改善、媒体流恢复为音视频流时，会触发该回调。

自从
V4.3.0
参数
isFallback本地发布流已回退或已恢复。
  • true: 由于网络环境不理想，发布的媒体流已回退为音频流。
  • false: 由于网络环境改善，从音频流恢复为音视频流。
streamType对应的视频流类型，即主流或辅流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLocalVideoRenderSizeChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLocalVideoRenderSizeChanged ( NERtcVideoStreamType videoType,
int width,
int height )

本地视频预览的分辨率变化回调, 与是否进入房间的状态无关，与硬件状态有关，也适用于预览

自从
V5.4.1
当本地视频的分辨率发生变化，会触发此回调。当调用 SetCaptureConfig 设置采集分辨率或调用 SetVideoConfig 设置编码属性时可以触发该回调。回调的分辨率宽和高为本地预览的宽和高，和实际编码发送的分辨率不一定一致，开发者可以根据该回调的分辨率来动态调整预览视图的比例等。
参数
videoType视频通道类型：kNERTCVideoStreamMain：主流。kNERtcVideoStreamSub：辅流。
width视频采集的宽，单位为 px
height视频采集的高，单位为 px

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onLocalVideoWatermarkState()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onLocalVideoWatermarkState ( NERtcVideoStreamType videoStreamType,
int state )

本地视频水印生效结果回调。

自从
V4.6.10
参数
videoStreamType对应的视频流类型，即主流或辅流。详细信息请参考 video.NERtcVideoStreamType。
state水印状态。详细信息请参考 NERtcConstants.NERtcLocalVideoWatermarkState。
参见
NERtcEx.setLocalVideoWatermarkConfigs(NERtcVideoStreamType, NERtcVideoWatermarkConfig)

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onMediaRelayReceiveEvent()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onMediaRelayReceiveEvent ( int event,
int code,
String channelName )

跨房间媒体流转发状态发生改变回调。

参数
event当前媒体流转发事件。详细信息请参考 NERtcConstants.ChannelMediaRelayEvent。
code相关错误码。详细信息请参考 NERtcConstants.ErrorCode。
channelName媒体流转发的目标房间名。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onMediaRelayStatesChange()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onMediaRelayStatesChange ( int state,
String channelName )

跨房间媒体流转发状态发生改变回调。

参数
state当前跨房间媒体流转发状态。详细信息请参考 NERtcConstants.ChannelMediaRelayState。
channelName媒体流转发的目标房间名。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onMediaRightChange()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onMediaRightChange ( boolean isAudioBannedByServer,
boolean isVideoBannedByServer )

服务端禁言音视频权限变化回调。

自从
v4.6.0
参数
isAudioBannedByServer是否禁用音频。
  • true：禁用音频。
  • false：取消禁用音频。
isVideoBannedByServer是否禁用视频。
  • true：禁用视频。
  • false：取消禁用视频。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPermissionKeyWillExpire()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPermissionKeyWillExpire ( )

权限密钥即将过期事件回调。

  • 由于 PermissionKey 具有一定的时效，在通话过程中如果 PermissionKey 即将失效，SDK 会提前 30 秒触发该回调，提醒用户更新 PermissionKey。
    自从
    V4.6.29
    使用前提
    主房间内请在 NERtcCallbackEx 接口类中通过 NERtc#init() 接口设置回调监听。
    相关接口
    在收到此回调后可以调用 NERtc#updatePermissionKey() 方法更新权限密钥。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPlayStreamingDuration()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPlayStreamingDuration ( String streamId,
long totalDurationS,
long currentPtsS )

播放流播放时长回调。

触发时机
当播放拉流播放时长变化时，会收到 onPlayStreamingDuration 回调。
参数说明
参数名称 类型 描述
streamId String 播放流 ID。
totalDurationS long 播放流总时长，单位为秒。
currentPtsS long 播放流当前播放时间，单位为秒。
自从
V5.9.15

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPlayStreamingFirstAudioFramePlayed()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPlayStreamingFirstAudioFramePlayed ( String streamId,
long timeMs )

播放流首帧音频播放回调。

触发时机
当播放拉流首帧音频播放时，会收到 onPlayStreamingFirstAudioFramePlayed 回调。
参数说明
参数名称 类型 描述
streamId String 播放流 ID。
timeMs long 首帧音频播放时间，单位为毫秒。
自从
V5.9.10

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPlayStreamingFirstVideoFrameRender()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPlayStreamingFirstVideoFrameRender ( String streamId,
long timeMs,
int width,
int height )

播放流首帧视频渲染回调。

触发时机
当播放拉流首帧视频渲染时，会收到 onPlayStreamingFirstVideoFrameRender 回调。
参数说明
参数名称 类型 描述
streamId String 播放流 ID。
timeMs long 首帧视频渲染时间，单位为毫秒。
width int 首帧视频渲染宽度，单位为像素。
height int 首帧视频渲染高度，单位为像素。
自从
V5.9.10

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPlayStreamingReceiveSeiMessage()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPlayStreamingReceiveSeiMessage ( String streamId,
String message )

播放流接收 SEI 消息回调。

触发时机
当播放拉流过程中收到 SEI 消息时，会收到 onPlayStreamingReceiveSeiMessage 回调。
参数说明
参数名称 类型 描述
streamId String 播放流 ID。
message String SEI 消息内容。
自从
V5.8.25

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPlayStreamingStateChange()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPlayStreamingStateChange ( String streamId,
int state,
int reason )

播放流状态改变回调。

触发时机
当播放拉流状态改变时，会收到 onPlayStreamingStateChange 回调。
参数说明
参数名称 类型 描述
streamId String 播放流 ID。
state NERtcLivePlayStreamState 播放流状态。
reason NERtcError 状态改变的原因。详见 NERtcError。
自从
V5.9.10

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onPushStreamingReconnectedSuccess()

default void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPushStreamingReconnectedSuccess ( )

推流过程中重连成功回调。 该回调在如下情况下会被触发：

  • 重连中重连成功
    自从
    4.6.420

◆ onPushStreamingReconnecting()

default void com.netease.lava.nertc.sdk.NERtcCallbackEx.onPushStreamingReconnecting ( int reason)

推流过程中断开，变为重连状态回调。 该回调在如下情况下会被触发：

  • startPushStreaming 成功开启推流，推流过程中推流状态变为重连中。
    自从
    4.6.420
    参数
    reason变为重连的原因，请参考 NERtcConstants.ErrorCode

◆ onReconnectingStart()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onReconnectingStart ( )

重连开始回调。
客户端和服务器断开连接时，SDK 会进行重连，重连开始时触发此回调。重连结果请参考 onReJoinChannel、onDisconnect。

参见
NERtcCallbackEx.onReJoinChannel(int, long)
NERtcCallbackEx.onDisconnect(int)

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onRecvSEIMsg()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onRecvSEIMsg ( long userID,
String seiMsg )

收到远端流的 SEI 内容回调。
当远端成功发送 SEI 后，本端会收到此回调。

参数
userID发送 SEI 的用户 ID。
seiMsg对应用户的 SEI 信息。
参见
NERtcEx.sendSEIMsg(String)

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onReJoinChannel()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onReJoinChannel ( int result,
long channelId )

重新加入房间回调。
在弱网环境下，若客户端和服务器失去连接，SDK 会自动重连。自动重连成功后触发此回调方法。

参数
result0 成功；其他值表示重新加入失败，错误码请参考 NERtcConstants.ErrorCode。
channelId客户端加入的房间 ID。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onRemoteAudioVolumeIndication()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onRemoteAudioVolumeIndication ( NERtcAudioVolumeInfo[] volumeArray,
int totalVolume )

提示房间内谁正在说话及说话者瞬时音量的回调。
该回调默认为关闭状态。可以通过 enableAudioVolumeIndication 方法开启。开启后，无论房间内是否有人说话，SDK 都会按 enableAudioVolumeIndication 方法中设置的时间间隔触发该回调。
在返回的数组中：

  • 如果有 uid 出现在上次返回的数组中，但不在本次返回的数组中，则默认该 uid 对应的远端用户没有说话。
  • 如果 volume 为 0，表示该用户没有说话。
  • 如果数组为空，则表示此时远端没有人说话。
    参数
    volumeArray每个说话者的用户 ID 和音量信息的数组。详细信息请参考 stats.NERtcAudioVolumeInfo。
    totalVolume混音后的总音量，取值范围为 0~100。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onRemoteSubscribeFallbackToAudioOnly()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onRemoteSubscribeFallbackToAudioOnly ( long uid,
boolean isFallback,
NERtcVideoStreamType streamType )

订阅的远端流已回退为音频流、或已恢复为音视频流回调。
如果您调用了设置远端订阅流回退选项 setRemoteSubscribeFallbackOption 接口并将 option 设置 AUDIO_ONLY 后，当下行网络环境不理想、仅接收远端音频流时，或当下行网络改善、恢复订阅音视频流时，会触发该回调。

自从
V4.3.0
参数
uid远端用户的 ID。
isFallback远端订阅流已回退或恢复。
  • true： 由于网络环境不理想，订阅的远端流已回退为音频流。
  • false：由于网络环境改善，订阅的远端流从音频流恢复为音视频流。
streamType对应的视频流类型，即主流或辅流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onRemoteVideoSizeChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onRemoteVideoSizeChanged ( long userId,
NERtcVideoStreamType videoType,
int width,
int height )

接收的远端视频分辨率变化的回调。

自从
V5.4.1
当远端用户视频流的分辨率发生变化时，会触发此回调，例如推流端调用 SetVideoConfig 更改了编码分辨率设置，本地会收到该远端用户分辨率变化通知。开发者可根据视频流的最新分辨率来更新 UI。
参数
userId远端用户 ID，指定是哪个用户的视频流
videoType视频通道类型：kNERtcVideoStreamTypeMain：主流。kNERtcVideoStreamTypeMain：辅流。
width视频采集的宽，单位为 px
height视频采集的高，单位为 px

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onStartPushStreaming()

default void com.netease.lava.nertc.sdk.NERtcCallbackEx.onStartPushStreaming ( int result,
long channelId )

/* 开始推流 startPushStreaming 结果回调。 该回调在如下情况下会被触发：

  • 成功调用 startPushStreaming。
    自从
    4.6.420
    参数
    resultOK 成功；其他值表示开始推流失败，错误码请参考 NERtcConstants.ErrorCode。
    channelId房间 ID。

◆ onStopPushStreaming()

default void com.netease.lava.nertc.sdk.NERtcCallbackEx.onStopPushStreaming ( int result)

停止推流 stopPushStreaming 结果回调。 该回调在如下情况下会被触发：

  • 成功调用 stopPushStreaming。
    自从
    4.6.420
    参数
    resultOK 成功；其他值表示停止推流失败，错误码请参考 NERtcConstants.ErrorCode。

◆ onUpdatePermissionKey()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUpdatePermissionKey ( String key,
int error,
int timeout )

更新权限密钥事件回调。

  • 调用 NERtc#updatePermissionKey() 方法主动更新权限密钥后，SDK 会触发该回调，返回权限密钥更新的结果。
    自从
    V4.6.29
    使用前提
    主房间内请在 NERtcCallbackEx 接口类中通过 NERtc#init() 接口设置回调监听。
    注解
    此回调暂不支持在子房间内返回。
    参数说明
    参数名称 类型 描述
    key String 新的权限密钥。
    error int 错误码。更多请参考 NERtcConstants.ErrorCode。
    • ENGINE_ERROR_CHANNEL_PERMISSION_KEY_ERROR（30901）：权限密钥错误。
    • ENGINE_ERROR_CHANNEL_PERMISSION_KEY_TIMEOUT（30902）：权限密钥超时。
    timeout int 更新后的权限密钥剩余有效时间。单位为秒。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserAudioMute()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserAudioMute ( long uid,
boolean muted )

远端用户暂停或恢复发送音频流的回调。

注解
该回调由远端用户调用 muteLocalAudioStream 方法开启或关闭音频发送触发。
参数
uid用户 ID，提示是哪个用户的音频流。
muted是否停止发送音频流。
  • true：该用户已暂停发送音频流。
  • false：该用户已恢复发送音频流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserDataBufferedAmountChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserDataBufferedAmountChanged ( long uid,
long previousAmount )

远端用户数据通道 buffer 变更回调。

参数
uid远端用户 ID。
previousAmount变更前大小。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserDataReceiveMessage()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserDataReceiveMessage ( long uid,
ByteBuffer bufferData,
long bufferSize )

远端用户通过数据通道发送数据的回调。

参数
uid远端用户 ID。
bufferData数据。
bufferSize数据大小。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserDataStart()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserDataStart ( long uid)

远端用户开启数据通道的回调。

参数
uid远端用户 ID。
自从
V5.0.0

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserDataStateChanged()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserDataStateChanged ( long uid)

远端用户数据通道状态变更回调。

参数
uid远端用户 ID。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserDataStop()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserDataStop ( long uid)

远端用户停用数据通道的回调。

参数
uid远端用户 ID。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserSubStreamAudioMute()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserSubStreamAudioMute ( long uid,
boolean muted )

远端用户暂停或恢复发送音频辅流的回调。

自从
V4.6.10
参数
uid用户 ID，提示是哪个用户的音频辅流。
muted是否停止发送音频辅流。
  • true：该用户已暂停发送音频辅流。
  • false：该用户已恢复发送音频辅流。
参见
NERtcEx.enableLocalSubStreamAudio(boolean)

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserSubStreamAudioStart()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserSubStreamAudioStart ( long uid)

远端用户开启音频辅流回调。

自从
V4.6.10
参数
uid远端用户 ID。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserSubStreamAudioStop()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserSubStreamAudioStop ( long uid)

远端用户停用音频辅流回调。

自从
V4.6.10
参数
uid远端用户 ID。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserSubStreamVideoStart()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserSubStreamVideoStart ( long uid,
int maxProfile )

远端用户开启屏幕共享辅流通道的回调。

参数
uid远端用户 ID。
maxProfile远端视频分辨率等级。详细信息请参考 NERtcConstants.VideoProfile。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserSubStreamVideoStop()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserSubStreamVideoStop ( long uid)

远端用户停止屏幕共享辅流通道的回调。

参数
uid远端用户 ID。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserVideoMute() [1/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserVideoMute ( long uid,
boolean muted )

远端用户暂停或恢复发送视频流回调。
当远端用户调用 muteLocalVideoStream 取消或者恢复发布视频流时，SDK 会触发该回调向本地用户报告远程用户的发流状况。

注解
该回调仅在远端用户的视频主流状态改变时会触发，若您希望同时接收到远端用户视频辅流状态变更的通知，请监听 NERtcCallbackEx#onUserVideoMute(NERtcVideoStreamType streamType, long uid, boolean muted) 回调。
参数
uid用户 ID，提示是哪个用户的视频流。
muted是否停止发送视频流。
  • true：该用户已暂停发送视频流。
  • false：该用户已恢复发送视频流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserVideoMute() [2/2]

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserVideoMute ( NERtcVideoStreamType streamType,
long uid,
boolean muted )

远端用户暂停或恢复发送视频回调。
当远端用户调用 NERtcEx#muteLocalVideoStream(NERtcVideoStreamType streamType, boolean mute) 方法取消或者恢复发布视频流时，SDK 会触发该回调向本地用户通知远端用户的发流情况。

自从
V4.6.20
参数说明
参数名称 类型 描述
uid long 用户 ID，提示是哪个用户的视频流。
muted boolean 是否暂停发送视频流：
  • true：该用户已暂停发送视频流。
  • false：该用户已恢复发送视频流。
streamType video.NERtcVideoStreamType 视频通道类型：
  • kNERtcVideoStreamTypeMain：主流。
  • kNERtcVideoStreamTypeSub：辅流。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserVideoProfileUpdate()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserVideoProfileUpdate ( long uid,
int maxProfile )

远端用户视频编码配置已更新回调。

参数
uid远端用户 ID。
maxProfile视频编码配置，详细信息请参考 NERtcConstants.VideoProfile。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserVideoStart()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserVideoStart ( long uid,
NERtcVideoStreamType streamType,
int maxProfile )

远端用户开启视频回调。
触发后，远端用户可以进行视频通话或直播。

参数
uid用户 ID，提示是哪个用户的视频流。
streamType视频通道类型，详细信息请参考 video.NERtcVideoStreamType。
maxProfile视频编码配置，详细信息请参考 NERtcConstants.VideoProfile。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onUserVideoStop()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onUserVideoStop ( long uid,
NERtcVideoStreamType streamType )

远端用户关闭视频回调。
触发后，远端用户停止进行视频通话或直播。

参数
uid用户 ID，提示是哪个用户的视频流。
streamType视频通道类型，详细信息请参考 video.NERtcVideoStreamType。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onVideoDeviceStageChange()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onVideoDeviceStageChange ( int deviceState)

视频设备状态已改变回调。
该回调提示系统视频设备状态发生改变，比如被拔出或移除。如果设备已使用外接摄像头采集，外接摄像头被拔开后，视频会中断。

参数
deviceState设备状态。详细信息请参考 NERtcConstants.VideoDeviceState。

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onVirtualBackgroundSourceEnabled()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onVirtualBackgroundSourceEnabled ( boolean enabled,
int reason )

通知虚拟背景是否成功开启的回调。
调用 NERtcEx#getFeatureSupportedType() 接口启用虚拟背景功能后，SDK 会触发此回调。

注解
如果自定义虚拟背景是 PNG 或 JPG 格式的图片，SDK 会在读取图片后才会触发此回调，因此可能存在一定延时。
自从
V4.6.10
参数
enabled是否已成功开启虚拟背景。
  • true：成功开启虚拟背景。
  • false：未成功开启虚拟背景。
reason虚拟背景开启出错的原因或开启成功的提示。 NERtcConstants.NERtcVirtualBackgroundSourceStateReason

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

◆ onWarning()

void com.netease.lava.nertc.sdk.NERtcCallbackEx.onWarning ( int code)

发生警告回调。
该回调方法表示 SDK 运行时出现了网络或媒体相关的警告。
通常情况下，App 可以忽略 SDK 上报的警告信息，SDK 会自动恢复。

参数
code警告码。NERtcConstants.WarningCode

在 com.netease.lava.nertc.sdk.AbsNERtcCallbackEx 内被实现.

该接口的文档由以下文件生成:
制作者 doxygen 1.12.0