custom_better_player 是一个基于 better_player 的 Flutter 视频播放器插件，提供了更多的自定义选项和功能。它支持多种视频格式、字幕、播放速度控制、画中画、全屏播放等功能。以下是如何在 Flutter 项目中使用 custom_better_player 的基本步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 custom_better_player 依赖：

dependencies:
  flutter:
    sdk: flutter
  custom_better_player: ^0.0.3  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 导入包

在你的 Dart 文件中导入 custom_better_player 包：

import 'package:custom_better_player/custom_better_player.dart';

3. 基本使用

你可以使用 CustomBetterPlayer 组件来播放视频。以下是一个简单的示例：

import 'package:flutter/material.dart';
import 'package:custom_better_player/custom_better_player.dart';

class VideoPlayerScreen extends StatefulWidget {
  [@override](/user/override)
  _VideoPlayerScreenState createState() => _VideoPlayerScreenState();
}

class _VideoPlayerScreenState extends State<VideoPlayerScreen> {
  late CustomBetterPlayerController _controller;

  [@override](/user/override)
  void initState() {
    super.initState();
    initializePlayer();
  }

  void initializePlayer() {
    var dataSource = CustomBetterPlayerDataSource(
      CustomBetterPlayerDataSourceType.network,
      "https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4",
    );

    _controller = CustomBetterPlayerController(
      CustomBetterPlayerConfiguration(),
      betterPlayerDataSource: dataSource,
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Custom Better Player'),
      ),
      body: Column(
        children: [
          AspectRatio(
            aspectRatio: 16 / 9,
            child: CustomBetterPlayer(
              controller: _controller,
            ),
          ),
        ],
      ),
    );
  }
}

4. 自定义配置

CustomBetterPlayerConfiguration 允许你自定义播放器的各种配置。例如，你可以设置自动播放、循环播放、全屏选项等：

CustomBetterPlayerConfiguration(
  autoPlay: true,
  looping: true,
  fullScreenByDefault: false,
  allowedScreenSleep: false,
  controlsConfiguration: CustomBetterPlayerControlsConfiguration(
    showControls: true,
    enableProgressBar: true,
    enablePlayPause: true,
    enableFullscreen: true,
  ),
)

5. 处理全屏模式

custom_better_player 支持全屏播放。你可以通过 CustomBetterPlayerController 来处理全屏模式：

_controller.enterFullScreen();
_controller.exitFullScreen();

6. 添加字幕

你可以通过 CustomBetterPlayerSubtitlesSource 来添加字幕：

var dataSource = CustomBetterPlayerDataSource(
  CustomBetterPlayerDataSourceType.network,
  "https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_20mb.mp4",
  subtitles: [
    CustomBetterPlayerSubtitlesSource(
      type: CustomBetterPlayerSubtitlesSourceType.network,
      name: "English",
      urls: ["https://www.example.com/subtitles_en.vtt"],
    ),
  ],
);

7. 处理播放事件

你可以监听播放器的事件，例如播放、暂停、完成等：

_controller.addEventsListener((event) {
  if (event.betterPlayerEventType == CustomBetterPlayerEventType.play) {
    print("Video started playing");
  } else if (event.betterPlayerEventType == CustomBetterPlayerEventType.pause) {
    print("Video paused");
  } else if (event.betterPlayerEventType == CustomBetterPlayerEventType.finished) {
    print("Video finished");
  }
});

8. 释放资源

在页面销毁时，记得释放播放器资源：

[@override](/user/override)
void dispose() {
  _controller.dispose();
  super.dispose();
}