React Native集成Agora SDK 4.3.2音视频通话失败求助

权限配置检查 #

• Android：确认AndroidManifest.xml中已添加必要权限：

  <uses-permission android:name="android.permission.CAMERA" />
  <uses-permission android:name="android.permission.RECORD_AUDIO" />
  <uses-permission android:name="android.permission.INTERNET" />
  

• iOS：在Info.plist中添加权限描述字段：

  <key>NSCameraUsageDescription</key>
  <string>需要访问相机进行音视频通话</string>
  <key>NSMicrophoneUsageDescription</key>
  <string>需要访问麦克风进行音视频通话</string>
  

• 代码中主动请求权限，确保权限获取成功后再初始化SDK，例如使用PermissionsAndroid：

  import { PermissionsAndroid } from 'react-native';
  
  const requestPermissions = async () => {
    const granted = await PermissionsAndroid.requestMultiple([
      PermissionsAndroid.PERMISSIONS.CAMERA,
      PermissionsAndroid.PERMISSIONS.RECORD_AUDIO,
    ]);
    return granted['android.permission.CAMERA'] === PermissionsAndroid.RESULTS.GRANTED &&
           granted['android.permission.RECORD_AUDIO'] === PermissionsAndroid.RESULTS.GRANTED;
  };
  

SDK 初始化与频道逻辑验证 #

• 确认App ID无拼写错误，且已在Agora控制台启用音视频服务。
• 初始化时注册关键事件回调，重点查看错误信息：

  import { createAgoraRtcEngine } from 'react-native-agora';
  
  const engine = createAgoraRtcEngine();
  engine.initialize({ appId: '你的App ID' });
  
  engine.registerEventHandler({
    onJoinChannelSuccess: (channel, uid, elapsed) => {
      console.log(`成功加入频道 ${channel}，用户ID：${uid}`);
      // 加入频道后启用视频并开始本地预览
      engine.enableVideo();
      engine.startPreview();
    },
    onUserJoined: (uid, elapsed) => {
      console.log(`远端用户 ${uid} 加入`);
      // 渲染远端用户视图
    },
    onError: (err, msg) => {
      console.error(`SDK错误：${err}，信息：${msg}`);
    },
  });
  
  // 加入频道
  engine.joinChannel('你的Token', '频道名', 0, {});
  

视图渲染检查 #

• 确保AgoraVideoView组件正确配置并赋予明确宽高：

  import { AgoraVideoView } from 'react-native-agora';
  
  // 本地预览视图
  <AgoraVideoView
    videoSource={{ uid: 0, channelId: '频道名' }}
    style={{ width: '100%', height: 400 }}
  />
  
  // 远端用户视图（需存储远端用户UID）
  <AgoraVideoView
    videoSource={{ uid: remoteUid, channelId: '频道名' }}
    style={{ width: '100%', height: 400 }}
  />
  

环境与依赖排查 #

• 执行npm list react-native-agora确认SDK版本为4.3.2。
• 检查React Native版本是否与SDK兼容（建议RN 0.60+）。
• 清理项目缓存：npm start -- --reset-cache，重新编译项目。
• Android端：进入android目录执行./gradlew clean && ./gradlew assembleDebug重新构建。
• iOS端：执行pod install，清理Xcode缓存后重新编译。

错误日志排查 #

• Android：使用Android Studio Logcat过滤Agora关键词，查找错误信息。
• iOS：通过Xcode控制台查看SDK输出的日志。
• 对照Agora错误码文档，根据onError回调返回的错误码定位问题。

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