BGM 弹幕库接入——Baka 如何自动关联弹幕

什么是 BGM 弹幕库

BGM（bgm.tv）是国内最大的番剧弹幕平台之一，弹幕库包含了几乎所有主流番剧的用户弹幕。Baka 接入 BGM 弹幕库后，播放任意番剧时可以自动拉取对应的弹幕。

与其他弹幕源相比，BGM 的优势：

• 覆盖全：新番最快上线，老番也有历史弹幕
• 弹幕质量：社区氛围好，水弹幕相对少
• 多来源：B 站、优酷、腾讯视频等多个来源的弹幕整合
• API 开放：官方提供稳定的开放接口

自动关联机制

Baka 播放番剧时，弹幕自动关联流程：

开始播放 "鬼灭之刃" 第 5 集
        │
        ▼
查询 BGM 数据库（按番剧名模糊匹配）
        │
        ├─ 找到 "鬼灭之刃" → 自动关联
        └─ 没找到 → 手动选择番剧 ID
        │
        ▼
根据集数请求弹幕接口
        │
        ▼
获取弹幕列表（XML 或 JSON 格式）
        │
        ▼
弹幕渲染层按时间戳叠加显示

匹配不上怎么办

偶尔会遇到自动匹配失败的情况：

• 番剧名有别名：如 "鬼灭之刃" 有时被写为 "Demon Slayer"
• 不同平台译名不同：如 "进击的巨人" vs "Attack on Titan"
• 番剧版本差异：如 "鬼灭之刃 无限列车篇" 是独立条目

手动关联方法：

1. 播放界面点击弹幕设置图标
2. 选择"手动关联番剧"
3. 输入番剧的 BGM ID（可以在 BGM.tv 网站上查到）
4. 或手动搜索番剧名从结果列表中选择

关联成功后，Baka 会记住这个映射关系，下次自动使用。

弹幕加载时机

• 预加载：进入播放页时就开始拉取弹幕数据，边拉边渲染
• 按需加载：某些版本支持按时间窗口增量加载，节省流量
• 缓存策略：弹幕数据缓存到本地，同一番剧下次播放直接用缓存

弹幕量控制

部分热门番剧弹幕量巨大（一集可能几万条），全加载会：

• 增加加载时间
• 弹幕过于密集遮挡画面
• 影响渲染性能

Baka 对此的处理：

• 密度调节：默认只显示一部分弹幕，用户可以调密度（Shift + F）
• 按时间窗口：只加载当前播放时间附近的弹幕
• 过滤规则：按关键字、类型、发送者等条件过滤

与其他弹幕源的关系

除了 BGM，部分版本的 Baka 也支持接入：

• 哔哩哔哩弹幕
• 弹弹 play 自有弹幕库
• 本地导入弹幕文件（XML/JSON）

多弹幕源可以叠加显示，也可以切换为单一来源。