You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 19:15:01