#🔣 Universal

#简介

• 为支持的 HLS 平台添加双语字幕选项
  • 用户需要在播放器的字幕选项中选择脚本新增的双语字幕或翻译字幕选项，即可在播放器中显示双语字幕

#使用说明

• 基础: 直接使用（采用默认配置）

  • 默认主语言英文（自动），副语言中文（自动）
  • 兼容的平台：增加官方双语与翻译双语字幕选项
    • 如平台未提供副语言字幕，则仅增加翻译双语字幕选项
  • 不兼容[^4]的平台：将主语言字幕替换替换为双语字幕
  • 翻译器默认使用Google翻译进行字幕翻译，将字幕按127句为单位划分，进行整段翻译。

• 进阶: 配合Loon设置面板或Surge参数设置功能进行个性化设置

  • 提供一定的自定义设置，如主语言、副语言、翻译器选择等

• 高级: 配合BoxJs及订阅使用

  ℹ️ 用前须知：使用BoxJs进行配置将被视为专业用户，官方不受理因使用BoxJs配置导致的各种问题

  1. 安装BoxJs插件并更新引用资源或脚本:

  • 安装方法及下载链接详见: 🧰 BoxJs

  2. 在BoxJs的配置面板中进行个性化设置:
     1. 浏览器访问BoxJs.com
     2. 在应用页面点开DualSubs折叠
     3. 根据需要配置每个流媒体平台的设置
     4. (可选) 在DualSubs: Verify中配置第三方API验证信息
     5. (可选) 在DualSubs: Advanced Options中配置高级设置

  • 字幕类型为多选框，多选保存后，对应APP中的字幕选项也会增加对应的字幕选项
  • 首选语言为主语言，对应第一行字幕语言
  • 次选语言为副语言，对应第二行字幕语言
  • 需在字幕类型中勾选外部字幕,外部字幕文件URL中填写的字幕文件才会生效（需要为绝对路径，支持WebVTT, SRT）
  • 外部字幕偏移量为内置字幕时间轴矫正功能，时间单位为毫秒，正负整数，可以用来省略第三方字幕转换器
  • 播放记录缓存数量提供设置数量的复数缓存空间，当你的设备同时为局域网内多个设备提供流媒体平台字幕增强功能时，保证字幕数据不会错乱，同时对于Disney+这种自带长期缓存的流媒体平台，提供更好的兼容性
  • 时间戳公差为官方字幕或外部字幕匹配时，每句字幕匹配时的时间容差，因同平台同视频不同语言字幕往往交付不同翻译人员进行翻译，相同台词的时间戳可能有0.5秒-1.5秒乃至更多的误差，或者一句台词对应另外一种语言多句台词的情况，时间戳公差值会将此误差范围的台词视为同一句台词进行合并，且支持一句台词对多句台词合并

#功能列表

1. 官方播放器内提供自定义字幕选项

• 对于不兼容的播放器，提供了一个字幕选项，用来强制替换字幕为指定字幕类型。

2. 自定义启用的第三方字幕种类
3. 双语官方字幕
4. 双语翻译字幕
   1. Google 翻译
   2. Google Cloud Translate API
      1. V2版
      2. V3版
   3. Microsoft Translator
      1. 国际版
      2. 中国版
      3. 美国政府版
      4. Edge Translator
   4. DeepL
      1. Free
      2. Pro
5. 双语外挂字幕
6. 中文，英文，西班牙文自动回退

• 中文（自动）回退顺序为中文（简体）-中文（繁體）-中文（香港）/粤语（廣東話）
• 英文（自动）回退顺序为English (US) [CC]-English (US)-English (UK)
• 西班牙文（自动）回退顺序为Español (Latinoamérica) [CC]-Español (Latinoamérica)-Español (España) [CC]-Español (España)

7. 自定义字幕匹配时间戳容差值
8. 自定义外挂字幕时间戳偏移量
9. 翻译字幕模式支持逐段翻译（默认）和逐行翻译

• 逐段翻译对于大分段的字幕文件的平台（如：HBO Max）响应更快，翻译效果更好，利于限制使用频率的翻译API。

#安装链接

• 因v0.8版结构升级，旧版用户请清空DualSubs在BoxJs的全部设置后重新设置
• 因iOS16.4起MitM政策变更，TV及Fitness平台，需要配合 iRingo: 📺 TV恢复支持
• 本模块不包含YouTube平台支持，如需要请单独下载🍿 DualSubs: ▶ YouTube
• 本模块不包含Netflix平台支持，如需要请单独下载🍿 DualSubs: 🇳 Netflix
• 本模块不包含Spotify平台支持，如需要请单独下载🍿 DualSubs: 🎵 Spotify

#更新日志

• V1.1.x
  • 增加 Spotify 歌词翻译功能
• V0.9.x ~ V1.0.x
  • 增加 文件格式判断功能
  • 增加 Google Translate V3 翻译接口
  • 增加 Microsoft Translate 翻译接口
  • 更改 URL Query
  • 重构 字幕选项写入功能
  • 修复 播放器内字幕选项
  • 更新 EXTM3U 解析器
  • 更新 WebVTT 解析器
• V0.8.x
  • 同步新的环境架构
  • 分离翻译器（翻译字幕脚本）与合成器（合成字幕脚本）
  • 增加 Google 翻译接口
  • 增加 Azure 美国政府版 翻译接口
  • 简化 BoxJs 设置面板
  • 重构 官方字幕缓存架构
  • 修复 DeepL 翻译接口
  • 更新 EXTM3U 解析器
  • 更新 WebVTT 解析器

#相关链接

🔣 Universal	🇳 Netflix	▶️ YouTube (Music)	🎵 Spotify		➕ AddOn	🧰 BoxJs