功能&特点

• FFmpeg 8.1.2
• 支持透传 FFmpeg option 参数
• 支持获取下载速度
• 支持获取预加载进度
• 获取基本信息（音频：采样率、声道数、时长等，视频：宽、高、fps、时长等）
• 支持获取首帧解码时间、渲染时间
• 支持 file、http、https、udp、rtmp、rtp、rtsp、bluray、smb、ftp 等协议
• 支持设置 HTTP 超时、错误重试、UA、Cookie、Referer、Origin 等，如果是 m3u8 支持透传给 ts 请求
• 支持 HLS 直播或者点播
• 支持 AV1、uavs3 解码器
• 支持播放音频时显示内置封面
• 支持播放图片
• 支持精准 seek
• 支持软硬解设置
• 支持多实例播放
• 支持播放完成（EOF）后，重新seek继续播放
• 优化了 file 协议 seek 后起播慢问题
• 音视频加密播放
• 强大的字幕功能
  • 文本字幕(srt/vtt/ass)
  • 图形字幕(dvbsub/dvdsub/pgssub/idx+sub)
  • 同时支持内嵌和外挂
  • 支持设置字幕延迟
  • 支持 ASS 字幕的特效
  • 支持设置文本字幕的样式
• 支持循环播放
• 支持切换音轨
• 支持设置音轨延迟
• 支持随时截屏（jpg、png、tiff）
• 支持设置视频显示比例
• 支持设置旋转角度设置（0,90,180,270）
• 支持设置水平镜像，垂直镜像
• 支持设置视频镜像模式
• 支持设置视频背景颜色（默认黑色）
• 支持设置画面饱和度、亮度、对比度
• 支持将画面同时渲染到多个 View 上
• 支持实时获取音频 PCM 数据
• 支持自定义渲染 View
• 支持 4K/HDR/HDR10/HDR10+/Dolby Vision，Pro版本支持 Dolby Vision P5
• 智能识别 iso (blury、dvd、普通视频)
• mpegts 视频快进不花屏
• 支持网络协议播放 iso 镜像和 BDMV 文件夹
• 双声道音频可强制指定声道播放
• 获取当前显示的视频帧
• 录制视频，iOS保存到相册可播放
• 支持播放webp动画
• 支持自定义音频渲染器
• 缓冲进度通知
• 支持异步销毁，即使不调用 shutdown 也能正常销毁
• 支持设定播放器不管理 AudioSession 状态
• 优化播放器 View 旋转时的动画效果
• 支持播放瓦片网格 HEIC
• 支持高斯模糊背景

最新支持

• 播放 HDR 视频时支持点亮 HDR 屏幕
• 优化了音频比视频短，只剩下视频时可以正常观看和seek
• 软硬解切换不需要重启播放器
• 开启视频滤镜，软解支持反交错
• 同步销毁播放器

调研中

• AV1 可以硬解，但个别视频会崩溃
• 直播回放
• 音视频可变速变调
• 支持透明视频
• 画中画

如果之前使用的 ijkplayer，可以轻松迁移到 fsplayer，请参考 迁移指南 。

构建环境

• macOS Tahoe(26.5)
• Xcode Version 26.6 (17F113)

更新记录

• CHANGELOG.md

集成

FSPlayer 完全免费，使用 LGPLv3 许可协议发布，感觉不错可以 请作者喝咖啡 。

• 通过 Swift Package Manger 集成: FSPlayer-SPM.git

• 通过 Cocoapods 集成:

pod "FSPlayer", :podspec => 'https://github.com/debugly/fsplayer/releases/download/1.1.0/FSPlayer.spec.json'

调用

FSOptions *options = [FSOptions optionsByDefault];
//创建播放器
self.player = [[FSPlayer alloc] initWithContent:url options:options];
//创建播放器渲染view
NSView <FSVideoRenderingProtocol>*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];

更详细的使用说明文档

编译步骤

源码完全开放，可以自己编译 Framework：

# Build iOS Framework
./FFToolChain/main.sh install -p ios -l 'ass ffmpeg'
./examples/ios/build-framework.sh
# Build macOS Framework
./FFToolChain/main.sh install -p macos -l 'ass ffmpeg'
./examples/macos/build-framework.sh
# Build tvOS Framework
./FFToolChain/main.sh install -p tvos -l 'ass ffmpeg'
./examples/tvos/build-framework.sh

FSPlayer-Pro

在 FSPlayer 的基础上提供了更加强劲的功能，以动态库的形式提供。

• Dolby Vision P5
• HLS 点播边播边缓存，已经缓存的 seek 回去播放不再耗流量，起播速度更快
• 无缝切换音轨，避免了普通方式切换后需要seek到当前位置，播放器重新加载短暂没有声音并且黑屏的问题
• 无缝切换清晰度
• 播放网络 iso 镜像和 BDMV 文件夹时，首帧起播速度提升x倍，Seek 后首帧起播速度提升x倍

邮件联系：debugly@icloud.com