文档首页 > > SDK参考> Android SDK> 接口参考> 事件回调

事件回调

分享
更新时间:2020/11/26 GMT+08:00

本章节介绍了Android SDK的回调接口IHRTCEngineEventHandler的详情。

表1 回调接口

接口

描述

onWarning

警告回调,暂不提供

onError

错误回调

onJoinRoomSuccess

成功加入房间回调

onJoinRoomFailure

加入房间失败回调

onLeaveRoom

离开房间回调

onUserJoined

用户加入房间回调

onUserOffline

用户离开房间回调

onConnectionStateChange

网络连接状态改变回调

onLogUploadResult

日志上传结果回调

onLogUploadProgress

日志上传进度回调

onUserRoleChanged

用户角色改变回调

onAudioRouteChanged

音频路由改变回调

onUserSubStreamAvailable

辅流加入房间回调

onRenderVideoFrame

回调远端的视频原始数据流

onPlaybackAudioFrame

回调远端的音频原始数据流

onVideoStats

视频流详情,2s触发一次回调

onAudioStats

音频流详情,2s触发一次回调

onSubStreamStats

辅流详情,2s触发一次回调

onConnectOtherRoom

跨房事件回调

onDisconnectOtherRoom

结束跨房事件回调

onRemoteAudioStateChanged

远端音频流状态变化回调

onRemoteVideoStateChanged

远端视频流状态变化回调

onRejoinRoomSuccess

重新加入房间回调

onUserVolumeStats

提示频道远端用户以及自己的音量回调

onStartAudioFileNotify

开始播放音频文件回调

onStopAudioFileNotify

停止播放音频文件回调

onPauseAudioFileNotify

暂停播放音频文件回调

onResumeAudioFileNotify

恢复播放音频文件回调

onNetworkTestQuality

会前网络探测质量上报回调

onNetworkTestResult

会前网络探测结果上报回调

onWarning

void onWarning(int warn, String msg);

功能说明

警告回调,暂不提供。

onError

void onError(int error, String msg);

功能说明

错误回调。

回调参数
  • error:错误码,具体请参见HRTCErrorCode
  • msg:错误描述。

onJoinRoomSuccess

void onJoinRoomSuccess(String roomId, String userId);

功能说明

成功加入房间回调。

回调参数
  • roomId:房间ID。
  • userId:用户ID。

onJoinRoomFailure

void onJoinRoomSuccess(String roomId, String userId);

功能说明

加入房间失败回调。

回调参数

  • error:错误码。
  • msg:错误信息。

onLeaveRoom

void onLeaveRoom(HRTCLeaveReason reason, HRTCStatsInfo statsInfo);

功能说明

离开房间回调。

回调参数
  • reason:自己离开房间的原因,具体请参见HRTCLeaveReason
  • statsInfo:会议期间的统计信息,具体请参见HRTCStatsInfo

onUserJoined

void onUserJoined(String roomId, String userId, String userName);

功能说明

用户加入房间成功回调。

回调参数

  • roomId:房间ID。
  • userId:用户ID。
  • userName:用户名称。

onUserOffline

void onUserOffline(String roomId, String userId, int reason);

功能说明

用户离开房间回调。

回调参数

  • roomId:房间ID。
  • userId:用户ID。
  • reason:预留字段。

onConnectionStateChange

void onConnectionStateChange(HRTCConnStateTypes connStateTypes, HRTCConnChangeReason connChangeReason, String description);

功能说明

网络连接状态改变。

回调参数

onLogUploadResult

void onLogUploadResult(int result);

功能说明

日志上传结果回调。

回调参数

result:日志上传结果,0表示成功,1表示失败。

onLogUploadProgress

void onLogUploadProgress(int progress);

功能说明

日志上传进度回调。

回调参数

progress:进度,取值范围为[0,100]

onUserRoleChanged

void onUserRoleChanged(String roomId, HRTCRoleType oldRole, HRTCRoleType newRole);

功能说明

用户角色改变。

回调参数
  • roomId:发生角色切换的房间号。
  • oldRole:改变前的角色,具体请参见HRTCRoleType
  • newRole:改变后的角色,具体请参见HRTCRoleType

onAudioRouteChanged

void onAudioRouteChanged(HRTCAudioRoute route);

功能说明

音频路由改变。

回调参数

route:音频路由,具体请参见HRTCAudioRoute

onUserSubStreamAvailable

void onUserSubStreamAvailable(String roomId, String userId, boolean available);

功能说明

辅流加入房间。

回调参数

  • roomId:房间ID。
  • userId:用户ID。
  • available:true为辅流开始推送,false为辅流停止推送。

onRenderVideoFrame

void onRenderVideoFrame(String roomid,String userId,byte[] buf, int videoFrameType,int width,int height,int len);

功能说明

回调远端的视频原始数据流。

回调参数

  • roomid:房间ID。
  • userId:用户ID。
  • buf:视频数据。
  • videoFrameType:视频类型,预留字段,当前只有YUV420。
  • width:宽度。
  • height:高度。
  • len:数据长度。

onRenderDataFrame

void onRenderDataFrame(String roomId, HRTCMediaDirection direction, String userId, HRTCVideoFrame videoFrame);

功能说明

回调远端的原始共享数据流。

回调参数
  • roomId:房间ID
  • direction:数据方向,本地或者远端,具体请参见HRTCMediaDirection
  • userId:用户ID
  • videoFrame:视频帧数据,具体请参见HRTCVideoFrame

onPlaybackAudioFrame

void onPlaybackAudioFrame(String roomid,byte[] buf,int audioFrameType,int sampleRate,int samplesPerSec,int bytesPerSample,int channels);

功能说明

回调远端的音频原始数据流。

回调参数

  • roomid:房间ID。
  • buf:音频数据。
  • audioFrameType:帧类型,预留字段。
  • sampleRate:音频采样率。
  • samplesPerSec:每秒采样数。
  • bytesPerSample:每个采样点占用字节数。
  • channels:频道数。

onVideoStats

void onVideoStats(List<HRTCLocalVideoStats> localStats, List<HRTCRemoteVideoStats> remoteStats);

功能说明

视频流详情,2s触发一次回调。

回调参数

onAudioStats

void onAudioStats(List<HRTCLocalAudioStats> localStats, List<HRTCRemoteAudioStats> remoteStats);

功能说明

音频流详情,2s触发一次回调。

回调参数

onSubStreamStats

void onSubStreamStats(List<HRTCLocalVideoStats> localStats, List<HRTCRemoteVideoStats> remoteStats);

功能说明

辅流详情,2s触发一次回调。

回调参数

onConnectOtherRoom

void onConnectOtherRoom(HRTCConnectInfo connectInfo, int error, String msg);

功能说明

跨房事件回调。

回调参数

  • connectInfo:跨房信息,具体请参见HRTCConnectInfo
  • error:错误码。
  • msg:错误描述。

onDisconnectOtherRoom

void onDisconnectOtherRoom(HRTCConnectInfo connectInfo, int error, String msg);

功能说明

结束跨房事件回调。

回调参数

  • connectInfo:跨房信息,具体请参见HRTCConnectInfo
  • error:错误码。
  • msg:错误描述。

onRemoteAudioStateChanged

void onRemoteAudioStateChanged(String userId, HRTCRemoteAudioStreamState state, HRTCRemoteAudioStreamStateReason reason);

功能说明

远端音频流状态变化回调。

回调参数

onRemoteVideoStateChanged

void onRemoteVideoStateChanged(String userId, HRTCRemoteVideoStreamState state, HRTCRemoteVideoStreamStateReason reason);

功能说明

远端视频流状态变化回调。

回调参数

onRejoinRoomSuccess

void onRejoinRoomSuccess(String roomId, String userId);

功能说明

重新加入房间回调。例如网络异常后重连成功加入房间触发。

回调参数

  • roomId:房间ID。
  • userId:用户ID。

onUserVolumeStats

void onUserVolumeStats(List<HRTCVolumeInfo> volumeInfos, int totalVolume);

功能说明

提示频道远端用户以及自己的音量回调。

回调参数
  • volumeInfos:回调发言人信息列表,目前最多支持4人,具体请参见HRTCVolumeInfo
  • totalVolume:远端混音后的总音量。

onStartAudioFileNotify

void onStartAudioFileNotify(int result);

功能说明

开始播放音频文件回调。

回调参数

result:0表示成功,其他表示失败。

onStopAudioFileNotify

void onStopAudioFileNotify(int result);

功能说明

结束播放音频文件回调。

回调参数

result:0表示成功,其他表示失败。

onPauseAudioFileNotify

void onPauseAudioFileNotify(int result);

功能说明

暂停播放音频文件回调。

回调参数

result:0表示成功,其他表示失败。

onResumeAudioFileNotify

void onResumeAudioFileNotify(int result);

功能说明

暂停恢复播放音频文件回调。

回调参数

result:0表示成功,其他表示失败。

onNetworkTestQuality

void onNetworkTestQuality(HRTCNetworkQualityLevel level);

功能说明

会前网络探测质量上报,探测成功后每隔两秒刷新该level值。

回调参数

level:值越大,表示网络质量越好,具体请参见HRTCNetworkQualityLevel

onNetworkTestResult

void onNetworkTestResult(HRTCNetworkTestResult networkTestResult);

功能说明

会前网络探测结果上报,如果探测成功,该回调会在探测30s后上报,如果失败随时上报。

回调参数

networkTestResult:网络探测结果数据,具体请参见HRTCNetworkTestResult

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问