Emby Danmaku 项目技术文档

Emby Danmaku 项目技术文档

jellyfin-danmaku Jellyfin danmaku extension 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-danmaku

1. 安装指南

1.1 浏览器插件安装（推荐）

1. 首先，安装 Tampermonkey 浏览器扩展。
2. 安装完成后，点击 添加脚本 链接，Tampermonkey 会自动提示安装脚本。

1.2 修改服务端安装

1. 对于 Docker 版本或其他类似版本，找到并编辑文件 /system/dashboard-ui/index.html。
2. 在文件的 </body> 标签前添加以下代码：

   <script src="https://cdn.jsdelivr.net/gh/RyoLee/emby-danmaku@gh-pages/ede.user.js" defer></script>
   

3. 保存文件并重启服务端。

1.3 修改客户端安装

1. 解包客户端的 dashboard-ui/index.html 文件。
2. 在 </body> 标签前添加与服务端相同的脚本代码。
3. 重新打包客户端。对于 iOS 设备，需要通过类似 AltStore 的方式进行自签名。

2. 项目使用说明

2.1 界面功能介绍

• 弹幕开关：用于切换弹幕的显示与隐藏状态。
• 手动匹配：允许用户手动输入信息以匹配弹幕。
• 简繁转换：在原始弹幕、简体中文和繁体中文三种模式之间切换。
• 过滤等级：调整弹幕过滤的强度，等级越高，过滤强度越大，0级表示无限制。
• 弹幕信息：通过通知和后台日志显示当前匹配的弹幕信息。

2.2 弹幕来源

弹幕数据来源于 弹弹 play，并已开启弹幕聚合功能，支持多个网站的弹幕融合。

2.3 数据存储

匹配完成后，对应关系会保存在浏览器或客户端的本地存储中。后续播放时，会优先按照保存的匹配记录加载弹幕。

3. 项目API使用文档

由于项目主要通过浏览器插件和服务端脚本实现功能，API文档部分主要涉及脚本的调用和配置。具体API调用方式请参考项目源码和相关注释。

4. 项目安装方式

4.1 浏览器插件安装

通过 Tampermonkey 安装用户脚本，具体步骤如上所述。

4.2 服务端安装

通过修改服务端的 index.html 文件，添加脚本标签实现安装。

4.3 客户端安装

通过解包客户端文件，修改 index.html 并重新打包实现安装。对于 iOS 设备，需要进行自签名。

5. 常见问题与解决方案

5.1 弹幕加载错误/失败原因

1. 译名导致的异常：如 Emby 识别为《彻夜之歌》，但弹弹 play 中为《夜曲》，导致无法匹配。
2. 多季/剧场版/OVA 导致的异常：如 OVERLORD 第四季使用 S[N] 格式归档时，可能出现匹配失败。
3. 其他加载BUG：如遇到问题，请在项目仓库中 开个issue。

首次播放时，请检查弹幕信息是否正确匹配，若匹配错误，请尝试手动匹配。

jellyfin-danmaku Jellyfin danmaku extension 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-danmaku