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

Flutter集成Agora遇onMediaDeviceChanged参数不匹配错误求助

问题解决:Agora Flutter SDK版本不兼容错误

错误根源

你遇到的是agora_uikit与agora_rtc_engine版本不兼容的问题:

  • agora_uikit:1.1.0基于旧版Agora RTC Engine API开发,代码中调用了onMediaDeviceChanged回调参数
  • 你当前使用的agora_rtc_engine:6.1.0已对RtcEngineEventHandler的API做了变更,移除了该参数,导致参数不匹配报错

两种解决方案

方案1:降低agora_rtc_engine版本到兼容范围

修改项目的pubspec.yaml文件,指定与agora_uikit:1.1.0兼容的RTC Engine版本:

dependencies:
  agora_uikit: ^1.1.0
  agora_rtc_engine: ^5.3.0

执行命令更新依赖:

flutter pub get

方案2:升级agora_uikit到最新版本

新版本的agora_uikit已适配agora_rtc_engine 6.x系列API,直接升级即可:
修改pubspec.yaml:

dependencies:
  agora_uikit: ^latest_version # 替换为pub上的最新版本号

执行flutter pub get更新依赖,之后检查代码中是否有uikit API的变更(通常新版本会保持向下兼容)

内容的提问来源于stack exchange,提问作者Ampeire Richard

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.07 02:50:29