产品简介
AVPlayerViewController-Subtitles 是一个开源的iOS库,允许开发者在AVPlayerViewController中快速集成SRT字幕显示功能。它解决了iOS原生播放器字幕支持不足的痛点,适合需要为视频应用添加字幕的iOS开发者使用。

核心功能
- 显示SRT格式字幕文件
- 作为Swift扩展易于集成
- 支持CocoaPods和手动安装
- 从v1.2起支持字幕文本搜索
- 可自定义字幕样式如颜色
快速开始
- 通过CocoaPods安装:在Podfile添加 pod 'AVPlayerViewController-Subtitles'
- 或手动下载Swift文件添加到项目
- 在代码中导入AVPlayerViewControllerSubtitles模块
- 创建播放器并加载视频,使用addSubtitles方法添加字幕文件
- 播放视频即可显示字幕
界面预览

与其他方案对比
| 对比项 | AVPlayerViewController-Subtitles | 同类方案 |
|---|---|---|
| 集成难度 | 作为Swift扩展,几行代码即可集成 | 原生iOS播放器需自行处理字幕解析和显示 |
| 字幕搜索功能 | 支持无需播放搜索字幕文本(v1.2+) | 同类库通常只支持实时字幕显示 |
| 开源许可 | Apache 2.0开源许可,免费使用 | 可能有些库有使用限制 |
适合谁用
- 需要为iOS视频应用添加SRT字幕功能的开发者
- 开发AVPlayerViewController播放器的iOS团队
- 希望快速集成字幕显示的Swift程序员
下载与版本
当前最新版本为 v1.4.0,发布于 2025-08-28。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/mhergon/AVPlayerViewController-Subtitles