Flutter API 33下配置Jitsi ConnectionService后闪屏黑屏问题求助

排查方向与实用解决方案 #

1. 调整ConnectionService的android:exported属性 #

API 33对组件的exported属性校验更严格，若该服务无需被外部应用调用，建议将其设为false，减少不必要的启动时初始化开销：

<service
    android:name="org.jitsi.meet.sdk.ConnectionService"
    android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE"
    android:exported="false">
    <intent-filter>
        <action android:name="android.telecom.ConnectionService" />
    </intent-filter>
</service>

2. 修复闪屏页主题配置 #

黑屏大概率是闪屏主题的背景未正确设置，在styles.xml中给闪屏主题明确指定背景资源：

<style name="SplashTheme" parent="Theme.AppCompat.NoActionBar">
    <item name="android:windowBackground">@drawable/你的闪屏图资源</item>
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
    <item name="android:statusBarColor">@android:color/transparent</item>
</style>

同时在AndroidManifest.xml中给闪屏Activity绑定该主题，避免系统默认的黑屏过渡：

<activity
    android:name=".SplashActivity"
    android:theme="@style/SplashTheme"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

3. 延迟Jitsi组件初始化 #

若ConnectionService在应用启动时提前初始化导致主线程阻塞，可在Flutter侧延迟初始化Jitsi SDK，等闪屏页完成后再执行：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 先加载闪屏页
  runApp(const SplashScreen());
  // 延迟1秒后初始化Jitsi并跳转主页面
  Future.delayed(const Duration(seconds: 1), () {
    JitsiMeet().initialize();
    runApp(const MyApp());
  });
}

4. 补充API 33所需权限 #

API 33新增了POST_NOTIFICATIONS权限，Jitsi通话功能依赖该权限，需在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

同时在应用运行时动态请求该权限，避免权限缺失导致组件初始化异常。

5. 升级Jitsi SDK版本 #

旧版Jitsi SDK可能存在API 33兼容性问题，尝试升级到最新稳定版，在build.gradle中更新依赖：

dependencies {
    implementation 'org.jitsi.react:jitsi-meet-sdk:latest.release'
}

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