升级Agora iOS SDK至4.0.0+后语音通话代理方法未触发问题

1. 检查 Delegate 的设置线程 #

Agora SDK 4.x 对代理绑定的线程要求比低版本严格，必须在主线程设置 delegate：

• 初始化 AgoraRtcEngineKit 实例后，务必在主线程调用 engine.setDelegate(self)
• 之前低版本可能在异步线程设置也能正常回调，但4.x会直接忽略非主线程设置的代理

2. 核对 Delegate 方法签名 #

4.x 部分回调方法的签名有更新，参数或方法名和低版本不兼容，比如远程用户加入的回调：

• 低版本方法：rtcEngine(_ engine: AgoraRtcEngineKit, didJoinedOfUid uid: UInt, elapsed: Int)
• 4.x 对应方法：rtcEngine(_ engine: AgoraRtcEngineKit, didJoinChannel channel: String, withUid uid: UInt, elapsed: Int)
• 检查你的实现是否完全匹配4.x的方法签名，参数个数、类型不对都会导致回调不触发

3. 确认频道加入流程的正确性 #

4.x 对 joinChannelByToken 的参数要求有变化，比如调整了参数顺序或新增必填项：

• 确保调用 joinChannelByToken 时，channelId、uid、token 等参数传递正确，没有遗漏
• 先确认本地的 didJoinChannel 回调正常触发，只有成功加入频道后，远程用户的状态回调才会生效

4. 检查 Bitcode 相关配置 #

虽然上传问题解决了，但4.x SDK 本身不支持 Bitcode，必须确保：

• 项目 Build Settings 里的 Enable Bitcode 设为 NO，不要尝试开启
• 检查 Other Linker Flags，确保添加了 -ObjC（如果之前没加的话），否则SDK的代理方法可能无法被正确识别

5. 验证麦克风权限 #

4.x 对权限的校验更严格，没有麦克风权限会导致回调异常：

• 确认 Info.plist 中已添加 NSMicrophoneUsageDescription 权限描述
• 初始化SDK前必须获取到用户的麦克风授权，否则即使能初始化，也无法触发通话相关的回调

6. 开启日志排查 #

打开SDK的详细日志，找异常线索：

• 调用 engine.setLogLevel(.info) 和 engine.setLogFile(NSHomeDirectory() + "/Documents/agora.log")
• 查看日志中是否有代理绑定失败、频道加入错误、用户状态变更异常的信息，这些会直接指向问题原因

内容的提问来源于stack exchange，提问作者Kaushik