如何为Flutter BetterPlayerPlaylist添加事件监听器

问题原因 #

你之前的绑定方式无效，核心原因有两个：

1. 手动创建的_betterPlayerController和BetterPlayerPlaylist内部实际使用的控制器不是同一个实例，绑定了也不会触发事件。
2. 在initState中直接绑定_betterPlayerPlaylistController!.betterPlayerController!时机过早，此时内部控制器还未完成初始化，导致监听绑定失败。

有效实现方式 #

方式一：通过全局配置直接绑定事件监听 #

在初始化BetterPlayerPlaylist时，将事件监听配置到全局的BetterPlayerConfiguration中，这样Playlist内部的控制器会自动继承该监听：

@override
void initState() {
    super.initState();
    // 1. 配置播放器全局参数，包含事件监听
    final betterPlayerConfig = BetterPlayerConfiguration(
        // 你的其他播放器配置（如自动播放、分辨率等）
        eventListener: _handleEvent,
    );

    // 2. 配置播放列表参数
    final playlistConfig = BetterPlayerPlaylistConfiguration(
        loopVideos: false,
        nextVideoDelay: Duration(seconds: 0),
    );

    // 3. 初始化播放列表控制器
    _betterPlayerPlaylistController = BetterPlayerPlaylistController(
        betterPlayerConfig,
        playlistConfig,
        _dataSourceList, // 你的播放列表数据源
    );
}

// 事件处理函数
void _handleEvent(BetterPlayerEvent event) {
    if (event.betterPlayerEventType == BetterPlayerEventType.finished) {
        int currentIndex = _betterPlayerPlaylistController?.currentDataSourceIndex ?? -1;
        print("索引 $currentIndex 的视频播放完毕");
        
        // 执行你的业务逻辑：暂停播放器、跳转页面等
        _betterPlayerPlaylistController?.pause();
        
        // 后续如需继续播放下一个视频，可调用：
        // _betterPlayerPlaylistController?.nextVideo();
    }

    if (event.betterPlayerEventType == BetterPlayerEventType.play) {
        print("正在播放视频索引: ${_betterPlayerPlaylistController?.currentDataSourceIndex}");
    }

    if (event.betterPlayerEventType == BetterPlayerEventType.changedPlaylistItem) {
        print("切换到视频索引: ${_betterPlayerPlaylistController?.currentDataSourceIndex}");
    }
}

方式二：延迟绑定+播放列表项变化监听 #

通过延迟绑定确保内部控制器初始化完成，同时监听播放列表项切换，保证事件监听始终生效：

@override
void initState() {
    super.initState();
    _betterPlayerPlaylistController = BetterPlayerPlaylistController(
        BetterPlayerConfiguration(),
        BetterPlayerPlaylistConfiguration(),
        _dataSourceList,
    );

    // 延迟到页面渲染完成后绑定事件，确保内部控制器已初始化
    WidgetsBinding.instance.addPostFrameCallback((_) {
        _bindPlaylistEventListener();
        
        // 监听播放列表项切换，切换后重新绑定事件（避免失效）
        _betterPlayerPlaylistController?.addListener(() {
            _bindPlaylistEventListener();
        });
    });
}

// 封装绑定事件的方法
void _bindPlaylistEventListener() {
    // 先移除旧监听，避免重复绑定
    _betterPlayerPlaylistController?.betterPlayerController?.removeEventsListener(_handleEvent);
    // 添加新监听
    _betterPlayerPlaylistController?.betterPlayerController?.addEventsListener(_handleEvent);
}

// 事件处理函数同方式一
void _handleEvent(BetterPlayerEvent event) {
    // ... 同方式一的逻辑
}

注意事项 #

• 在页面销毁时，务必移除监听并释放资源，避免内存泄漏：

@override
void dispose() {
    _betterPlayerPlaylistController?.betterPlayerController?.removeEventsListener(_handleEvent);
    _betterPlayerPlaylistController?.dispose();
    super.dispose();
}

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