BiliLocal本地弹幕视频播放器使用指南

BiliLocal是一款免费开源的本地弹幕视频播放器，能够为本地视频文件加载并显示弹幕，让用户在离线环境下也能享受B站式的互动观影体验。

核心功能特色

智能弹幕匹配系统

BiliLocal支持两种弹幕获取方式：在线状态下可实时加载最新弹幕流，离线时则读取本地缓存的弹幕文件。通过src/Access模块下的网络配置与解析逻辑，确保弹幕数据的稳定获取与高效存储。

多引擎播放内核

内置四大播放器内核（src/Player/QPlayer.cpp、VPlayer.cpp等），支持MP4、MKV、AVI等几乎所有视频格式，配合src/Render模块的渲染优化，实现高清流畅播放。

自定义弹幕体验

通过src/Model/Shield.cpp和Danmaku.cpp提供的功能，可自定义弹幕速度、透明度、字体大小，甚至实现关键词屏蔽，打造个性化观影环境。

安装与配置

获取源码

git clone https://gitcode.com/gh_mirrors/bi/BiliLocal
cd BiliLocal

环境准备

Linux系统需要安装以下依赖：

sudo apt-get update
sudo apt-get install cmake make gcc g++ qt5-default

编译运行

mkdir build && cd build
cmake ..
make -j4
./BiliLocal

使用教程

视频弹幕匹配

1. 点击主界面「打开文件」按钮选择视频
2. 播放器自动尝试匹配在线弹幕（需联网）
3. 若匹配失败，可手动导入弹幕文件（支持.xml和.json格式）
4. 弹幕加载状态可在「信息」面板查看

弹幕渲染模式切换

在播放界面右键呼出菜单，可选择：

• 普通模式：基础文字弹幕显示
• 高级模式：支持彩色弹幕与特殊效果
• 极简模式：仅显示顶部重要弹幕

移动端使用

项目包含Android平台支持（res/Android目录），可通过Android Studio编译APK后在移动设备上使用。

实用技巧

弹幕自动备份

在设置中开启「自动保存弹幕」功能，系统会将加载过的弹幕自动保存，避免重复下载。

性能优化配置

通过修改src/Config.cpp中的性能配置项，可针对低配置设备优化播放效果：

config->set("video_quality", "720p");
config->set("max_danmaku", 300);

批量处理功能

支持批量为多个视频自动匹配并保存弹幕，适合整理本地视频库。

常见问题解决

问题现象	解决方案
弹幕不显示	检查弹幕文件完整性或重新匹配
视频无法播放	安装额外编解码器包
界面显示异常	检查字体配置或清理配置文件

技术架构说明

BiliLocal采用模块化设计，主要功能模块包括：

• src/Access：网络访问和弹幕加载模块
• src/Player：多引擎播放器内核
• src/Render：弹幕渲染引擎
• src/Model：数据模型管理
• src/UI：用户界面组件

项目当前版本为0.4.2，支持A站番剧和C站弹幕，提供纯弹幕透明模式等高级功能。

通过BiliLocal，用户可以让本地视频获得弹幕互动的乐趣，无论是学习、娱乐还是分享，都能带来全新的观看体验。