Flutter使用Chewie播放MP4视频时遭遇ExoPlayer渲染错误求助

错误原因解析 #

错误信息中的NO_EXCEEDS_CAPABILITES表明视频的编码参数（分辨率、码率或帧率）超出了当前设备MediaCodec的硬件解码能力，但你提到不使用Chewie时视频可正常播放，说明问题核心出在Chewie的初始化逻辑或配置上，而非视频本身或基础的video_player控制器。

解决方案 #

方案1：修正视频初始化流程（优先尝试）

你注释了await _controller.initialize();，依赖Chewie的autoInitialize: true完成初始化，但这种方式可能导致初始化时机紊乱，触发ExoPlayer的解码适配错误。正确的流程应该是先手动初始化VideoPlayerController，确认成功后再创建ChewieController。

修改后的_initializeVideoPlayer方法：

late VideoPlayerController _controller;
late ChewieController _chewieController;
bool _isInitialized = false; // 新增状态变量跟踪初始化状态

@override
void initState() {
  super.initState();
  _initializeVideoPlayer();
}

Future<void> _initializeVideoPlayer() async {
  try {
    _controller = VideoPlayerController.networkUrl(Uri.parse(widget.videoUrl));
    // 先手动完成基础控制器的初始化
    await _controller.initialize();
    
    // 初始化完成后再创建Chewie控制器，关闭autoInitialize
    _chewieController = ChewieController(
      videoPlayerController: _controller,
      autoInitialize: false,
      autoPlay: false,
      looping: false,
      showControls: true,
      aspectRatio: _controller.value.aspectRatio, // 绑定视频原生比例
      errorBuilder: (context, errorMessage) {
        return Center(
          child: Text(
            errorMessage,
            style: TextStyle(color: Colors.white),
          ),
        );
      },
    );
    
    setState(() {
      _isInitialized = true;
    });
  } catch (error) {
    print('Failed to initialize video player: $error');
    setState(() {
      _isInitialized = true;
    });
  }
}

@override
Widget build(BuildContext context) {
  return Container(
    width: double.infinity,
    height: MediaQuery.of(context).size.height/2,
    child: Stack(
      children: [
        // 使用状态变量判断，避免late变量未初始化的异常
        _isInitialized
            ? Chewie(controller: _chewieController)
            : const Center(child: CircularProgressIndicator()),
        
        // 你的下载、分享按钮组件...
      ],
    ),
  );
}

方案2：启用解码器降级（针对硬件解码不支持的设备）

如果设备确实无法硬件解码该视频，可以通过配置ExoPlayer，让其在硬件解码失败时自动切换到软件解码：

1. 打开Android项目的MainActivity.kt（路径：android/app/src/main/kotlin/[你的包名]/MainActivity.kt）
2. 添加以下配置：

import android.os.Bundle
import androidx.annotation.NonNull
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugins.videoplayer.VideoPlayerPlugin
import com.google.android.exoplayer2.DefaultRenderersFactory

class MainActivity: FlutterActivity() {
    override fun configureFlutterEngine(@NonNull flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        // 启用解码器降级策略
        val renderersFactory = DefaultRenderersFactory(this)
            .setEnableDecoderFallback(true)
        VideoPlayerPlugin.setRenderersFactory(renderersFactory)
    }
}

方案3：调整视频渲染缩放模式

添加缩放配置，强制视频适配容器尺寸，降低设备解码压力：

_chewieController = ChewieController(
  // ...其他配置
  zoomAndPan: true, // 允许缩放平移
  // 强制使用固定比例适配容器
  aspectRatio: MediaQuery.of(context).size.width / (MediaQuery.of(context).size.height/2),
)

补充优化 #

• 修正dispose方法：由于_controller和_chewieController是late初始化的，不会为null，直接调用dispose()即可：

@override
void dispose() {
  _controller.dispose();
  _chewieController.dispose();
  super.dispose();
}

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