Flutter集成Agora遇AgoraRtcException(20)及(-17)问题求助

核心原因：异步初始化未完成就执行join操作 #

你的initState中直接连续调用了setupVideoSDKEngine()和join()，但setupVideoSDKEngine()是异步方法，包含权限请求、引擎初始化等耗时操作，join()会在初始化完成前就执行，导致引擎未就绪，触发AgoraRtcException(20, Make sure you call RtcEngine.initialize first)异常。

AgoraRtcException(-17, null)通常也是因引擎未正确初始化就执行频道操作导致的衍生错误。

修复步骤 #

1. 确保初始化完成后再调用join #

修改initState，等待setupVideoSDKEngine()执行完毕后再调用join()：

@override
void initState() {
  super.initState();
  // 使用then链式调用，保证初始化完成后执行join
  setupVideoSDKEngine().then((_) => join());
}

或者通过WidgetsBinding的帧回调处理（更稳妥，避免initState直接处理异步的潜在问题）：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    await setupVideoSDKEngine();
    join();
  });
}

2. 修正事件处理器中的笔误 #

在onUserJoined回调中，你写了_remoteUid = uid;，这里的uid未定义，应该替换为参数中的remoteUid：

onUserJoined: (RtcConnection connection, int remoteUid, int elapsed) {
  showMessage("Remote user uid:$remoteUid joined the channel");
  setState(() {
    _remoteUid = remoteUid; // 修正此处
    player.stop();
    customTimer!.resetAndStart();
  });
},

3. 额外检查项 #

• 确认Environment.agoraAppId是有效的Agora App ID，无空值或拼写错误
• 权限请求后，检查是否真的获取到了麦克风和摄像头权限（可添加权限校验逻辑）
• 确保join()方法中使用的频道名、token（如果需要）是正确的

验证 #

修改后重新运行，引擎初始化完成后才会执行join操作，应该能正常加入频道，不再抛出初始化相关异常。

内容的提问来源于stack exchange，提问作者Abdelrahman M. Elmarakby