Flutter中如何使用Agora检测视频通话对端用户是否退出
基于agora_rtc_engine检测对端用户离开通话的实现方法
你用的agora_rtc_engine库本身已经原生支持覆盖所有你提到的场景的对端离开检测,无需额外引入第三方依赖,直接通过SDK自带的事件回调即可实现:
- 核心使用
RtcEngineEventHandler类中的onUserOffline回调,该回调会在远端用户离开频道或掉线时主动触发,回调会返回两个参数:- 触发事件的对端用户
uid - 用户离线原因枚举
UserOfflineReason,共三种枚举值覆盖所有场景:UserOfflineReason.quit:对端用户主动调用leaveChannel方法退出频道,对应主动挂断场景UserOfflineReason.dropped:SDK连续一段时间未收到对端的数据包,判定对端掉线,对应网络差、连接意外中断场景UserOfflineReason.becomeAudience:仅直播模式下生效,对端用户从主播身份切换为观众身份,点对点通话场景(通信模式)下不会触发该值
- 触发事件的对端用户
代码示例
// 初始化RtcEngine实例后注册事件回调即可监听 await _rtcEngine.registerEventHandler( RtcEngineEventHandler( onUserOffline: (int uid, UserOfflineReason reason) { // 此处写入你自己的业务逻辑,例如关闭通话页面、弹出提示、销毁渲染视图等 switch(reason) { case UserOfflineReason.quit: // 处理主动挂断逻辑 break; case UserOfflineReason.dropped: // 处理网络掉线逻辑 break; default: break; } }, // 可选:额外监听网络质量提前做弱网提示 onNetworkQuality: (int uid, int txQuality, int rxQuality) { // txQuality为对端上行质量,rxQuality为本地接收对端数据的下行质量,数值越低质量越好,0为未知、1最好、6最差 if (uid != 0 && rxQuality >= 5) { // 给本地用户弹出对端网络较差的提示 } } ), );
注意:该回调触发逻辑已经过SDK底层优化,不会出现误判的情况,无需自己额外做保活心跳逻辑。
内容的提问来源于stack exchange,提问作者Osama Remlawi
相关产品推荐
相关产品推荐

