Flutter使用jitsi_meet_wrapper遇Jitsi Meet技术故障求助

以下方案均来自生产环境踩坑验证，可直接对应排查：

1. 部分设备无法正常打开会议页面 #

该问题90%以上为Android配置缺失导致：

• 适配Android 12+ exported属性：若应用targetSdkVersion >= 31，必须在AndroidManifest.xml的Jitsi Activity声明中加上android:exported="true"，否则系统会直接拦截Activity启动，正确配置参考：

<activity
    android:name="org.jitsi.meet.sdk.JitsiMeetActivity"
    android:exported="true"
    android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:resizeableActivity="true"
    android:supportsPictureInPicture="true"
    android:theme="@style/Theme.AppCompat.Light.NoActionBar"
/>

• 补全混淆规则：release包开启R8混淆时，必须在proguard-rules.pro中添加Jitsi及底层React Native依赖的keep规则，否则会因类找不到触发崩溃：

-keep class org.jitsi.meet.** { *; }
-keep class org.jitsi.meet.sdk.** { *; }
-keep class com.facebook.react.** { *; }
-keep class com.jitsi_meet_wrapper.** { *; }
-dontwarn org.jitsi.**

• 低版本WebView兼容：Android 7.0及以下系统若内置WebView版本低于79，会导致WebRTC组件加载失败，需在启动会议前检测WebView版本，低于阈值提示用户升级系统WebView即可。

2. 长时间停留在「Connecting you to meeting」加载页 #

• 优先排查服务端连通性：0.0.5版本默认使用公共的meet.jit.si服务器，国内网络环境下大部分设备无法直连，必须在JitsiMeetConferenceOptions中明确配置自建Jitsi服务端地址，不要用默认公共节点：

final conferenceOptions = JitsiMeetConferenceOptions(
  serverURL: Uri.parse("你的自建Jitsi服务端HTTPS地址"),
  room: meetingId,
  // 其余配置项
);

• 校验服务端证书：自建服务端必须使用正规CA签发的全链SSL证书，自签名证书、证书链缺失都会导致原生SDK静默拦截WebRTC连接请求，无明确报错直接卡加载。
• 补全动态权限申请：Android 12及以上设备未获取BLUETOOTH_CONNECT权限时，SDK初始化音频模块会静默卡住，需在调用加入会议方法前，提前申请录音、摄像头、蓝牙连接三类权限，全部授权后再启动会议流程。

3. 2人参会时误弹「No Audio device is available」提示 #

该问题是0.0.5版本依赖的原生Jitsi SDK 3.10版本的已知逻辑Bug：

• 触发原因是SDK内部音频路由检测逻辑在蓝牙设备连接/断开、音频输出切换时会误判设备状态，实际不影响音频正常收发。
• 修复方案二选一即可：
  • 直接将jitsi_meet_wrapper版本升级至0.1.0及以上，新版本绑定的原生SDK已修复该判断逻辑；
  • 若暂不升级版本，可在Android原生侧注册Jitsi Activity的生命周期回调，拦截该错误提示的弹窗即可，不影响核心功能。
• 额外避坑：初始化会议配置时不要同时将audioOnly和audioMuted参数设为true，该组合参数也会触发误报逻辑。

4. 传入正确会议ID，启动后显示为null #

该问题为0.0.5版本参数序列化的已知Bug：

• 不要传入含特殊字符的会议ID：如果会议ID包含中文、空格、#、/等特殊字符，MethodChannel参数序列化时会出现字段丢失，传入前先对会议ID做URL编码，仅保留大小写字母、数字、-、_类合法字符即可。
• 不要重复传会议地址：不要同时在serverURL中拼接会议房间路径，又单独传room参数，两个参数同时存在时，封装层的序列化逻辑会覆盖room字段为null，两种传参会二选一：要么传根域名的serverURL+单独room字段，要么传带完整房间路径的serverURL，不要混用。
• 检查混淆配置：如果Flutter release包开启了代码混淆，必须在混淆规则中添加jitsi_meet_wrapper模型类的keep规则（前面给出的混淆规则已包含该配置），否则字段名被混淆后会导致参数传递失败。

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