Yamby 内嵌字幕与外挂字幕的选择与切换

两种字幕来源

视频的字幕来源分两种：

• 内嵌字幕（Embedded Subtitles）：字幕轨道直接打包在视频文件容器内（MKV/MP4/MOV），跟随视频一起存储
• 外挂字幕（External Subtitles）：独立文件，常见格式为 SRT / ASS / SSA / VTT，通常和视频文件放在同一目录，文件名相同（如 movie.mkv 和 movie.ass）

Emby 服务器刮削时会自动识别两种字幕源。Yamby 播放器默认优先加载：外挂字幕 > 内嵌字幕（同语言优先级相同）。

在播放器中切换字幕

播放界面点击屏幕唤起控制栏，然后点击 字幕图标（CC 或字幕形状）打开字幕选择面板：

• 当前视频所有可用字幕轨会列出（内嵌 + 外挂）
• 每条字幕显示语言代码（中文 / English / 日语等）和格式
• 可以临时关闭字幕（「关闭」选项）
• 选中后立即生效，无需重新加载视频

支持同时显示两条字幕轨——可以一条主字幕 + 一条辅助字幕（如双语对照）。

外挂字幕自动匹配

Emby 服务器的元数据引擎会自动尝试匹配视频文件的外挂字幕。匹配规则通常是：

1. 同目录下、文件名相同（仅扩展名不同）的字幕文件
2. 文件名包含语言标记（如 movie.zh-CN.ass）会被正确识别为对应语言
3. Emby 服务器配置了在线字幕源时，还会自动从 OpenSubtitles 等平台下载匹配字幕

如果 Yamby 里找不到某个字幕，先检查：

1. Emby 服务器 Web 面板 → 该视频的「编辑」→「字幕」标签页，确认字幕是否在服务器端已关联
2. 字幕文件命名是否规范（影片名.语言代码.格式）
3. Emby 服务器是否开启了外挂字幕识别

强制加载外挂字幕

某些特殊场景下（如 Emby 服务器未正确识别字幕文件），可以在播放器设置中尝试：

• 开启「优先加载外挂字幕」（默认已开启）
• 关闭「忽略 Emby 服务器字幕设置」（默认关闭，开启后 Yamby 会自己扫描目录）

一般保持默认即可。字幕匹配的主要工作量在 Emby 服务器端，Yamby 只负责呈现。

字幕编码问题

如果某些外挂字幕显示乱码，常见原因是字幕文件使用了 GBK 编码而非 UTF-8。MPV 内核有自动编码检测机制，绝大多数情况下可以自动识别并正确渲染。如果仍然乱码，可以在播放器设置里手动指定字幕编码（UTF-8 / GBK / Shift-JIS 等）。