Flutter_vlc_player初始化控制器时无法建立通道连接

报错信息 #

I/flutter ( 5004): PlatformException(channel-error, Unable to establish connection on channel., null, null)
I/flutter ( 5004): #0      VlcPlayerApi.create (package:flutter_vlc_player_platform_interface/src/messages/messages.dart:658:7)
I/flutter ( 5004): <asynchronous suspension>
I/flutter ( 5004): #1      VlcPlayerController.initialize (package:flutter_vlc_player/src/vlc_player_controller.dart:191:5)
I/flutter ( 5004): <asynchronous suspension>
I/flutter ( 5004): #2      VlcPlayerController.onPlatformViewCreated (package:flutter_vlc_player/src/vlc_player_controller.dart:984:7)
I/flutter ( 5004): <asynchronous suspension>

排查与解决步骤 #

• 对齐依赖版本：确保项目pubspec.yaml中flutter_vlc_player的版本和正常运行的示例项目完全一致，同时检查Android端build.gradle内依赖的VLC相关库版本是否匹配，版本不兼容是通道绑定失败的常见原因。
• 清理重建项目：依次执行以下命令彻底清理缓存后重新构建：

  flutter clean
  flutter pub get
  

  Android端额外执行：

  # macOS/Linux
  ./gradlew clean
  # Windows
  gradlew clean
  

• 检查Android配置：
  1. 确认AndroidManifest.xml中添加了必要权限：

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

  2. 在application或对应的activity标签中开启硬件加速：

     android:hardwareAccelerated="true"
     

• 调整初始化时机：避免在Flutter引擎未完全初始化时创建控制器，可在initState中延迟初始化，或等待引擎就绪后执行：

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

• 验证Flutter版本兼容性：如果项目Flutter版本与示例项目差异较大，尝试将Flutter升级或降级至示例项目使用的版本，测试是否解决问题。
• 检查Android项目基础配置：确保build.gradle中minSdkVersion不低于21（flutter_vlc_player的最低要求），同时gradle插件版本与当前Flutter版本兼容。

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