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

Flutter集成Agora后运行报错:函数参数类型不匹配

解决Agora UIKit与RTC Engine版本不兼容导致的函数类型不匹配错误

这个错误的核心原因是你使用的agora_uikit: ^1.3.3和agora_rtc_engine: ^6.1.0版本不兼容:新版本的agora_rtc_engine对LocalInvitation相关的回调函数签名做了修改,新增了一个String类型的参数,但旧版本的agora_uikit仍然沿用老的函数签名,导致类型不匹配。

下面是两种可行的解决方法:

方法一:降级agora_rtc_engine到兼容版本

agora_uikit 1.3.3的官方依赖要求是agora_rtc_engine >=5.3.0 <6.0.0,你可以把agora_rtc_engine的版本调整到这个区间内:

  1. 打开项目根目录的pubspec.yaml文件
  2. 修改依赖配置:
    agora_rtc_engine: ^5.4.0
    agora_uikit: ^1.3.3
    http: ^0.13.6
    
  3. 执行命令flutter pub get更新依赖
  4. 重新运行项目

方法二:升级agora_uikit到适配RTC Engine 6.x的版本

如果不想降级RTC Engine,可以升级agora_uikit到支持6.x版本的最新版(比如1.5.0及以上,具体可查看官方版本日志确认):

  1. 打开pubspec.yaml修改依赖:
    agora_rtc_engine: ^6.1.0
    agora_uikit: ^1.5.0
    http: ^0.13.6
    
  2. 执行flutter pub get更新依赖
  3. 重新运行项目

注意:升级agora_uikit后如果遇到其他API适配问题,可以参考官方的版本迁移说明调整代码。

内容的提问来源于stack exchange,提问作者Syed Irfan Hussaini

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.15 07:47:15