Yamby Dandanplay 弹幕加载失败排查

问题表现

情况一：弹幕按钮灰掉

正常行为，不是 bug。原因：

• 该视频是电影（Dandanplay 主要覆盖动漫剧集）
• 该视频是非中文源（欧美剧、韩剧等 Dandanplay 收录少）
• Yamby 的弹幕功能仅限中文弹幕源
• 当前播放器是系统播放器（弹幕只在 MPV 内核下可用，少数版本）

确认方法：换一部热门日本动漫剧集（如《鬼灭之刃》《咒术回战》）测试。如果还是灰，才是真的问题。

情况二：未找到弹幕

Dandanplay 匹配规则是根据视频名称搜索。匹配失败的常见原因：

1. 视频名称不标准

Emby 服务器刮削的标题可能和 Dandanplay 数据库里的名称不一致。比如：

不同译名、繁简体、罗马音 vs 中文 都可能导致匹配失败。

解决方法：在 Emby 服务器端手动修正影片标题，改成 Dandanplay 数据库里能找到的名称。Dandanplay 网站可以先搜索确认正确名称。

2. 冷门资源

小众动漫、老番、独立动画在 Dandanplay 可能没有收录弹幕。这是正常现象，Yamby 也没法凭空造出弹幕。

3. 网络问题

Dandanplay 的 API 可能被运营商墙掉或连接超时。测试方法：用手机浏览器打开 Dandanplay 网站，能访问 → 网络没问题；不能访问 → 需要代理。

情况三：弹幕卡顿或速度异常

已知 bug：Yamby 早期版本存在「暂停恢复后弹幕速度异常」的问题（暂停后再播放，弹幕会突然变快或变慢）。这个 bug 在后续版本中已修复。

解决方法：更新 Yamby 到最新版本。

网络波动：弹幕数据需要实时从 Dandanplay API 拉取。网络不稳定时弹幕加载会延迟或丢帧。改善 Wi-Fi 信号即可。

弹幕功能的性能影响

开启弹幕后播放器会额外加载一个 Canvas 层来渲染弹幕文字。对设备性能的影响非常小——即使是低端手机，开启弹幕后播放流畅度也不会有可感知的下降。

唯一需要注意的是：弹幕数据本身需要网络。如果是完全离线的视频播放（没有连接 Emby 服务器，只有本地文件），Dandanplay 弹幕自然无法加载。