XML弹幕转换
支持将XML格式的弹幕文件转换为 ASS 字幕格式，可用于弹幕压制或播放器加载。
底层使用 DanmakuFactory 实现，兼容 B 站弹幕
快速开始
使用界面
- 打开"工具" -> "弹幕转换"
- 选择XML弹幕文件
- 配置转换参数
- 点击"开始转换"
使用预设
为常用配置创建预设，避免重复设置：
- 配置好转换参数
- 点击"保存为预设"
- 输入预设名称
- 下次直接选择预设即可
配置选项
基础配置
视频分辨率
设置弹幕的目标分辨率，需要与视频分辨率一致，这个参数非常重要
自适应分辨率
支持自适应分辨率功能，可以根据视频自动调整，只在和视频压制时生效。
弹幕字体
选择弹幕显示的字体。
web和客户端使用的字体方式并不相同，会有差异，再加上获取字体 postscriptName 的微妙的有些不同，导致某些字体web中选择后无法使用。
docker下的emoji文本渲染错误，猜测和fontconfig有关，但是我不会改，如果你会欢迎发issue
字体大小
弹幕文字的大小，单位：像素。
推荐值：
- 1080p: 35-45
- 720p: 25-35
- 4K: 65-85
不透明度
弹幕的不透明度，范围：0-1。
- 1.0: 完全不透明
- 0.8: 推荐值
- 0.5: 半透明
- 0.0: 完全透明
弹幕过滤
屏蔽关键词
过滤包含特定关键词的弹幕。
支持正则表达式，每行一个关键词。
示例：
广告
联系方式
\d{6,} # 过滤6位以上数字（如QQ号）最小字数
过滤字数少于指定数量的弹幕。
推荐值：0-2
最大字数
过滤字数多于指定数量的弹幕（通常是刷屏）。
推荐值：30-50
用户等级限制
只显示等级高于指定值的用户弹幕。
适用于B站弹幕（需要XML包含等级信息）。
高级配置
弹幕密度
控制同时显示的弹幕数量。
- 低密度：阅读清晰，可能漏掉部分弹幕
- 中密度：平衡
- 高密度：不漏弹幕，可能重叠
弹幕速度
控制弹幕移动速度。
- 较慢：更容易阅读
- 正常：推荐
- 较快：适合弹幕密集的视频
描边宽度
弹幕文字的描边宽度，增强可读性。
推荐值：2-3
阴影
为弹幕添加阴影效果，增强可读性。
加粗
将弹幕文字设置为粗体。
保留底部弹幕
是否保留底部弹幕（通常用于特殊效果）。
保留顶部弹幕
是否保留顶部弹幕（通常用于重要提示）。
礼物弹幕
是否保留礼物提示弹幕。
进场弹幕
是否保留用户进场提示。
SC/舰长
是否保留SC（SuperChat）和舰长提示。
批量转换
支持批量转换多个弹幕文件：
- 选择多个XML文件
- 使用相同的配置
- 批量转换
与Webhook配合
可以在Webhook中配置自动转换弹幕：
- 打开"设置" -> "Webhook"
- 启用"自动转换弹幕"
- 选择弹幕预设
录制完成后会自动转换弹幕。
与视频压制配合
转换后的ASS字幕可以直接用于视频压制：
- 打开"工具" -> "转码"
- 选择视频文件
- 选择ASS字幕文件
- 开始压制
预设管理
创建预设
- 配置好转换参数
- 点击"保存为预设"
- 输入预设名称和描述
使用预设
- 在预设下拉菜单中选择
- 参数会自动填充
- 可以微调后再转换
编辑预设
- 选择要编辑的预设
- 修改参数
- 点击"更新预设"
删除预设
- 选择要删除的预设
- 点击"删除预设"
- 确认删除
导入导出预设
可以导出预设分享给他人，或备份预设：
- 点击"导出预设"保存为文件
- 点击"导入预设"加载文件
故障排除
弹幕转换失败
如果你是Windows新安装的系统，请尝试安装系统相关运行库，如果不是，也请安装试试。
转换失败
- 检查XML文件是否完整
- 检查文件编码是否为UTF-8
- 尝试使用其他弹幕文件测试
- 查看日志获取详细错误
弹幕显示不全
- 增加弹幕密度
- 减小字体大小
- 减少过滤条件
弹幕重叠
- 降低弹幕密度
- 增加弹幕速度
- 增加弹幕时长
字体无法显示
- 确认系统已安装该字体
- 尝试使用系统默认字体
- Docker环境需要挂载字体目录