NERtc Android SDK
Public 成员函数 | 所有成员列表
com.netease.lava.nertc.sdk.NERtcCallback接口 参考
类 com.netease.lava.nertc.sdk.NERtcCallback 继承关系图:
com.netease.lava.nertc.sdk.NERtcCallbackEx

Public 成员函数

void onJoinChannel (int result, long channelId, long elapsed)
 
void onLeaveChannel (int result)
 
void onUserJoined (long uid)
 
void onUserLeave (long uid, int reason)
 
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)
 

详细描述

NERtc 异步回调接口,用户需要实现该接口来完成对NERtc各种状态回调的处理

成员函数说明

◆ onClientRoleChange()

void com.netease.lava.nertc.sdk.NERtcCallback.onClientRoleChange ( int  oldRole,
int  newRole 
)

直播场景下用户角色已切换回调。
用户加入房间后,通过 setClientRole 切换用户角色后会触发此回调。例如从主播切换为观众、从观众切换为主播。

注意
直播场景下,如果您在加入房间后调用该方法切换用户角色,调用成功后,会触发以下回调:

  • 主播切观众,本端触发 onClientRoleChange 回调,远端触发 onUserLeave 回调。
  • 观众切主播,本端触发 onClientRoleChange 回调,远端触发 onUserJoined 回调。

    参数
    oldRole切换前的角色。详细信息请参考 NERtcConstants.UserRole
    newRole切换后的角色。详细信息请参考 NERtcConstants.UserRole

◆ onDisconnect()

void com.netease.lava.nertc.sdk.NERtcCallback.onDisconnect ( int  reason)

网络连接中断,且 SDK 连续 3 次重连服务器失败。

注意

  • SDK 在调用 joinChannel 加入房间成功后,如果和服务器失去连接且连续 3 次重连失败,就会触发该回调。
  • 如果 SDK 在断开连接后,连续 3 次重连失败,SDK 会停止尝试重连。

    参数
    reason网络连接中断原因。详细信息请查看 NERtcConstants.ErrorCode

◆ onJoinChannel()

void com.netease.lava.nertc.sdk.NERtcCallback.onJoinChannel ( int  result,
long  channelId,
long  elapsed 
)

加入房间回调,表示客户端已经登入服务器。

参数
result0 表示加入房间成功;其他值表示加入房间失败,详细错误码请参考 NERtcConstants.ErrorCode
channelId客户端加入的房间 ID。
elapsed从 joinChannel 开始到发生此事件过去的时间,单位为毫秒。

◆ onLeaveChannel()

void com.netease.lava.nertc.sdk.NERtcCallback.onLeaveChannel ( int  result)

退出房间回调。 App 调用 leaveChannel 方法后,SDK 提示 App 退出房间是否成功。

参数
result0 表示成功;其他值表示退出房间失败,错误码请参考 NERtcConstants.ErrorCode。 在快速切换房间时 code 为 NERtcConstants.ErrorCode::LEAVE_CHANNEL_FOR_SWITCH。

◆ onUserAudioStart()

void com.netease.lava.nertc.sdk.NERtcCallback.onUserAudioStart ( long  uid)

远端用户开启音频回调。

参数
uid远端用户 ID。

◆ onUserAudioStop()

void com.netease.lava.nertc.sdk.NERtcCallback.onUserAudioStop ( long  uid)

远端用户停用音频回调。

参数
uid远端用户 ID。

◆ onUserJoined()

void com.netease.lava.nertc.sdk.NERtcCallback.onUserJoined ( long  uid)

远端用户加入当前房间回调。
该回调提示有远端用户加入了房间,并返回新加入用户的 ID;如果加入之前,已经有其他用户在房间中了,新加入的用户也会收到这些已有用户加入房间的回调。
该回调在如下情况下会被触发:

  • 远端用户调用joinChannel方法加入房间。
  • 远端用户网络中断后重新加入房间。

    参数
    uid新加入房间的远端用户 ID。

◆ onUserLeave()

void com.netease.lava.nertc.sdk.NERtcCallback.onUserLeave ( long  uid,
int  reason 
)

远端用户离开当前房间回调。
提示有远端用户离开了房间(或掉线)。

用户离开房间有两个原因,即正常离开和超时掉线:

  • 正常离开的时候,远端用户会收到消息提示,判断用户离开房间。
  • 超时掉线的依据是,在一定时间内(40~50s),用户没有收到对方的任何数据包,则判定为对方掉线。

    参数
    uid离开房间的远端用户 ID。

◆ onUserVideoStart()

void com.netease.lava.nertc.sdk.NERtcCallback.onUserVideoStart ( long  uid,
int  maxProfile 
)

远端用户开启视频回调。

参数
uid用户 ID,提示是哪个用户的视频流。
maxProfile视频编码配置,详细信息请参考 NERtcConstants.VideoProfile

◆ onUserVideoStop()

void com.netease.lava.nertc.sdk.NERtcCallback.onUserVideoStop ( long  uid)

远端用户停用视频回调。

参数
uid远端用户 ID。

该接口的文档由以下文件生成: