# fsplayer
**Repository Path**: debugly/fsplayer
## Basic Information
- **Project Name**: fsplayer
- **Description**: 🔥iOS/macOS/tvOS video player based on ijkplayer, using FFmpeg 6, support hw accel、4K、HDR、ass effect subtitle、bluray、smb...
- **Primary Language**: C
- **License**: LGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-12
- **Last Updated**: 2025-05-12
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
FSPlayer
[](https://github.com/debugly/fsplayer/stargazers)
## 功能&特点
- [x] FFmpeg 6.1.1
- [x] 支持透传FFmpeg option参数
- [x] 支持获取下载速度
- [x] 支持获取预加载进度
- [x] 获取基本信息（音频：采样率、声道数、时长等，视频：宽、高、fps、时长等）
- [x] 支持获取首帧解码时间、渲染时间
- [x] 支持file、http、https、udp、rtmp、rtp、rtsp、bluray、smb等协议
- [x] 支持设置HTTP超时、错误重试、UA、Cookie、如果是m3u8支持透传给ts请求
- [x] 支持HLS直播或者点播
- [x] 支持AV1、uavs3解码器
- [x] 支持单独播放音频显示内置封面
- [x] 支持单独播放图片
- [x] 支持精准 seek
- [x] 支持软硬解设置
- [x] 支持多实例播放
- [x] 支持播放完成（EOF）后，重新seek继续播放
- [x] 优化了file协议seek后起播慢问题
- [x] 音视频加密播放
- [x] 强大的字幕功能
- 文本字幕(srt/vtt/ass)
- 图形字幕(dvbsub/dvdsub/pgssub/idx+sub)
- 同时支持内嵌和外挂
- 支持设置字幕延迟
- 支持 ASS 字幕的特效
- 支持设置文本字幕的样式
- [x] 支持循环播放
- [x] 支持切换音轨
- [x] 支持设置音轨延迟
- [x] 支持随时截屏（jpg、png、tiff）
- [x] 支持设置视频显示比例
- [x] 支持设置旋转角度设置（0,90,180,270）
- [x] 支持设置视频镜像模式
- [x] 支持设置视频背景颜色（默认黑色）
- [x] 支持设置画面饱和度、亮度、对比度
- [x] 支持同时渲染到多个View上
- [x] 支持实时获取音频PCM数据
- [x] 支持自定义渲染View
- [x] 支持 4K/HDR/HDR10/HDR10+/Dolby Vision，不支持 Dolby Vision P5
- [x] 智能识别 iso (blury、dvd、普通视频)
- [x] mpegts 视频快进不花屏
- [x] 支持网络协议播放 iso 镜像和 BDMV 文件夹
- [x] 双声道音频可强制指定声道播放
正在开发的功能
- [ ] AV1 硬解
- [ ] 录制视频
- [ ] 直播回放
- [ ] 音视频可变速变调
- [ ] 支持透明视频
- [ ] 画中画
- [ ] Dolby Vision P5
如果之前使用的 ijkplayer，可以轻松迁移到 fsplayer，请参考 [迁移指南](./doc/migration.md) 。
## 构建环境
- macOS Sequoia(15.1)
- Xcode Version 16.2 (16C5032a)
| 最低支持平台 | 架构 |
| ----------- | -------------------------------------- |
| iOS 11.0 | arm64、arm64_simulator、x86_64_simulator |
| macOS 10.11 | arm64、x86_64 |
| tvOS 12.0 | arm64、arm64_simulator、x86_64_simulator |
## 更新记录
- [CHANGELOG.md](CHANGELOG.md)
## FSPlayer
FSPlayer 完全免费，使用 [LGPLv3](./COPYING.LGPLv3) 许可协议发布，感觉不错可以 [请作者喝咖啡](./Donate.md) 。
- 通过 Swift Package Manger 集成: [FSPlayer-SPM.git](https://github.com/debugly/FSPlayer-SPM.git)
- 通过 Cocoapods 集成:
```
pod "FSPlayer", :podspec => 'https://github.com/debugly/fsplayer/releases/download/1.0.0/FSPlayer.spec.json'
```
### 使用
```
FSOptions *options = [FSOptions optionsByDefault];
//创建播放器
self.player = [[FSPlayer alloc] initWithContentURL:url withOptions:options];
//创建播放器渲染view
NSView *playerView = self.player.view;
playerView.frame = self.playerContainer.bounds;
playerView.autoresizingMask = NSViewWidthSizable | NSViewHeightSizable;
[self.playerContainer addSubview:playerView positioned:NSWindowBelow relativeTo:self.playerCtrlPanel];
//加载完毕自动播放
self.player.shouldAutoplay = YES;
//异步加载
[self.player prepareToPlay];
```
更详细的使用[说明文档](https://fsplayer.debugly.cn/manuals/getting-started.html)
## FSPlayer-Pro
FSPlayer-Pro 在 FSPlayer 的基础上提供了更加强劲的功能，将以动态库的形式提供给付费用户。
- HLS 点播边播边缓存，已经缓存的seek回去播放不再耗流量，速度更快
- 可无缝切换音轨，避免了普通方式切换后需要seek到当前位置，播放器重新加载短暂没有声音并且黑屏的问题
- 播放网络 iso 镜像和 BDMV 文件夹时，首帧起播速度提升x倍，Seek 后首帧起播速度提升x倍
具体费用和规则请邮件联系：[debugly@icloud.com](mailto:debugly@icloud.com)