弹幕与字幕

字幕和弹幕是播放器顶部 / 底部按钮的两个常驻入口，也各对应一组设置项。本篇按"播放器内即时调整"+"设置中的全局配置"两条线讲清楚。

字幕

在播放器里切换字幕

传输栏的字幕按钮弹出字幕面板，可以：

• 切换内嵌字幕轨道（电影/剧集自带的字幕）
• 加载本地字幕：从硬盘选择 .srt / .ass / .vtt 等
• 关闭字幕
• 进入字幕设置：精细调整外观

字幕设置（播放器内）

「字幕设置」面板覆盖了几乎所有 ASS 字幕渲染参数，这些设置会保存为偏好，下次播放新片时自动套用：

• 延迟：字幕与画面对不上时微调（毫秒级）
• 缩放 / 位置：字幕大小与显示位置
• 字体：选择系统字体或保持默认
• 外观：字体颜色、描边颜色、背景颜色、描边大小、阴影偏移、边框样式（描边 / 不透明框 / 背景框）、加粗、斜体
• 间距与对齐：水平/垂直对齐、边距、字间距、行间距、模糊
• 次要字幕：同时显示双语 / 双轨字幕，可设独立延迟、堆叠布局（顶 / 底 / 分开显示）、间隙

每一组都有「重置本节」按钮单独还原，整体也可以一键「恢复默认」。

自动选择字幕的偏好

如果想让应用每次自动选某种语言的字幕，去 设置 → 播放器设置 → 播放器行为：

• 偏好字幕语言：未设置 / 简体中文 / 繁体中文 / English / 日本語
• 默认不选择字幕：即便有字幕也不开（适合外语听力）

详见 播放器界面 → 播放器行为。

Whisper 实时字幕

当一段视频没有字幕（无内嵌、无外挂），Whisper 实时字幕可以本地用 AI 识别音频生成字幕，并可选 Google / Bing / 自有 AI 服务做实时翻译。

完整指南（硬件要求、模型选择、翻译服务、节流保护、所有参数）见独立章节：AI 字幕（Whisper）。

弹幕

在播放器里使用弹幕

传输栏的弹幕按钮弹出弹幕面板，可以：

• 总开关：当前媒体是否显示弹幕
• 加载本地弹幕（XML）
• 在线搜索弹幕：手动匹配
• 弹幕设置：透明度、字号、显示区域、滚动速度、描边大小、延迟、字体、显示类型（滚动 / 顶部 / 底部）

弹幕功能（设置）

入口：设置 → 播放器设置 → 弹幕功能。

关闭后将隐藏所有弹幕相关功能，包括播放器弹幕按钮、详情页弹幕匹配及弹幕自动加载。

设置项：

弹幕服务管理

入口：设置 → 外部服务设置 → 弹幕服务管理。

控制弹幕从哪里来。内置两个源，也可添加兼容服务：

底部还可以添加自定义弹幕源（兼容弹弹 Play API 的服务），并管理（启用/编辑/删除）已添加的源。

如果手头还没有可用的兼容服务，可以试试社区里两个常见的开源实现：misaka_danmu_server 与 danmu_api。它们都对外暴露弹弹 Play 风格的接口，自部署后填入服务地址即可使用。

服务类型：弹弹Play 兼容 vs. 御坂弹幕

「添加弹幕服务」对话框第一项「服务类型」决定客户端如何向服务端拉取弹幕：

• 弹弹Play 兼容服务（默认）：直接调用标准 /api/v2/comment/{episodeId} 同步接口，适配所有兼容弹弹 Play 协议的服务（含 danmu_api 与早于 2.7.0 的 misaka_danmu_server）。
• 御坂弹幕服务（Misaka Danmu）：针对 misaka_danmu_server 2.7.0+ 引入的异步弹幕生成接口。客户端会附加 ?async=1，若服务端返回 status=pending 与 taskId，则按 1.5 秒间隔轮询 /api/v2/taskcomment/{taskId}，弹幕菜单和弹幕按钮都会实时显示生成进度与服务端描述，完成后再调一次普通接口取回最终弹幕。轮询总上限 5 分钟，超时按失败处理。

只要服务端可用版本就老老实实选「御坂弹幕服务」，可以避开 30 秒同步窗口下的零结果；否则保持默认即可。

BiliBili 登录

入口：设置 → 外部服务设置 → BiliBili。

仅用于 BiliBili 弹幕源（应用本身不提供 B 站视频播放）。点击登录后扫码授权，登录态用于读取 B 站的弹幕轨道。

提示

• 没字幕怎么办？ 先看本地是否有同名字幕文件、传输栏字幕面板里能不能加载；都没有就用 Whisper 现场识别
• 弹幕匹配错了？ 弹幕面板里手动「在线搜索」改选；如果弹弹 Play 自动匹配总错，可关掉「自动匹配弹幕」
• 觉得弹幕挡画面？ 弹幕面板里调小「显示区域」（占屏幕的比例）或降低不透明度
• B 站弹幕没出来？ 确认「弹幕服务管理 → BiliBili」开关已开 + 已在「BiliBili」设置项里登录