Flutter中配合miniplayer使用BetterPlayer触发全屏时报错如何解决

问题原因 #

错误的核心诱因有两个：

1. miniplayer组件内部存在类型转换bug，int值未做转换直接赋值给double类型参数
2. 视频播放器的自带全屏逻辑和miniplayer的拖拽/状态监听逻辑冲突，全屏切换时反复触发界面重建导致渲染锁死、Surface资源异常释放

解决方案 #

• 修复miniplayer内部类型错误：打开miniplayer源码的utils.dart文件，定位到24行的borderDouble方法，将所有返回int值的逻辑修改为返回double类型，比如将return 0修改为return 0.0，如果是变量返回则追加.toDouble()转换。也可以在pubspec.yaml中通过依赖覆盖指定已经修复该问题的miniplayer分支版本。
• 禁用视频组件自带全屏逻辑，避免状态冲突：给better_player/chewie的初始化配置添加fullScreenEnabled: false参数，关闭其自带的全屏跳转逻辑。自定义全屏点击事件，触发时先暂停miniplayer的状态监听，再单独拉起全屏视频页，等退出全屏后再恢复miniplayer的状态。
• 修正状态更新时机：所有涉及miniplayer状态、视频播放状态的setState调用，全部包裹在WidgetsBinding.instance.addPostFrameCallback回调中，等待当前帧渲染完成后再更新状态，避免布局阶段触发重建导致的widget tree locked报错。
• 优化视频组件生命周期：给嵌入miniplayer的视频播放器组件添加AutomaticKeepAliveClientMixin，设置wantKeepAlive = true，避免miniplayer状态变化时视频组件被反复销毁重建，减少Surface资源异常释放的问题。

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