开源中国

我们不支持 IE 10 及以下版本浏览器

It appears you’re using an unsupported browser

为了获得更好的浏览体验,我们强烈建议您使用较新版本的 Chrome、 Firefox、 Safari 等,或者升级到最新版本的IE浏览器。 如果您使用的是 IE 11 或以上版本,请关闭“兼容性视图”。
SGPlayer首页、文档和下载 - 跨平台媒体播放器框架 - 开源中国社区
Float_left Icon_close
全部项目分类
我要评价
GPL
Objective-C 查看源码»
跨平台
libobjc
分享
收藏
19 人收藏
收录时间:2017-04-21
SGPlayer 详细介绍

SGPlayer

  • SGPlayer 是一款基于 AVPlayer、FFmpeg 的媒体资源播放器框架。支持360°全景视频,VR视频,RTMP、RTSP 等直播流;同时支持 iOS、macOS、tvOS 三个平台。

功能特点

  • 支持播放360°全景视频。

  • 支持手势、传感器操控360°全景视频。

  • 支持双眼模式,具有畸变校正、色散校正。

  • 支持 iOS、macOS、tvOS。

  • 支持 H.264 硬件解码(VideoToolBox)。

  • 支持 RTMP、RTSP 等直播流。

  • 支持后台播放。

  • 支持选择音频轨道。

  • 支持控制音频输出音量。

  • 支持无损视频截图。

  • 支持近所有常用媒体格式。

  • 支持 Bitcode。

  • 极简的事件通知机制。

编译方式(2选1即可)

1.脚本编译

// iOS
git clone https://github.com/libobjc/SGPlayer.git
cd SGPlayer
sh compile-build.sh iOS

// macOS
git clone https://github.com/libobjc/SGPlayer.git
cd SGPlayer
sh compile-build.sh macOS

// tvOS
git clone https://github.com/libobjc/SGPlayer.git
cd SGPlayer
sh compile-build.sh tvOS

2.手动编译

  • 步骤1 - 克隆项目并安装子模块

git clone git@github.com:libobjc/SGPlayer.git
cd SGPlayer
git submodule update --init --recursive
  • 步骤2 - 手动编译 FFmpeg 并放在指定目录下

// 将FFmpeg编译出的.a静态库分别放在对应目录
/SGPlayer/Classes/Core/SGFFPlayer/ffmpeg/lib-iOS        // iOS
/SGPlayer/Classes/Core/SGFFPlayer/ffmpeg/lib-macOS      // macOS
/SGPlayer/Classes/Core/SGFFPlayer/ffmpeg/lib-tvOS       // tvOS

使用示例

  • 详细使用示例参见 demo

iOS依赖

  • SGPlayer.framework

  • SGPlatform.framework Optional

  • CoreMedia.framework

  • AudioToolBox.framework

  • VideoToolBox.framework

  • libiconv.tbd

  • libbz2.tbd

  • libz.tbd

macOS依赖

  • SGPlayer.framework

  • SGPlatform.framework Optional

  • CoreMedia.framework

  • AudioToolBox.framework

  • VideoToolBox.framework

  • VideoDecodeAcceleration.framework

  • libiconv.tbd

  • libbz2.tbd

  • libz.tbd

  • libizma.tbd

基础视屏播放

self.player = [SGPlayer player];

// 注册事件通知
[self.player registerPlayerNotificationTarget:self stateAction:@selector(stateAction:) progressAction:@selector(progressAction:) playableAction:@selector(playableAction:) errorAction:@selector(errorAction:)];

// 视频画面点击事件
[self.player setViewTapAction:^(SGPlayer * _Nonnull player, SGPLFView * _Nonnull view) {
    NSLog(@"player display view did click!");
}];

// 播放普通视频 (2种方式2选1即可)
[self.player replaceVideoWithURL:contentURL]; // 方式1
[self.player replaceVideoWithURL:contentURL videoType:SGVideoTypeNormal]; // 方式2

// 播放360度全景视频、VR视频
[self.player replaceVideoWithURL:contentURL videoType:SGVideoTypeVR];

// 播放
[self.player play];

高级设置

// 三种预设播放内核选择策略
self.player.decoder = [SGPlayerDecoder defaultDecoder];     // 默认配置,混合使用 AVPlayer和FFmpeg,根据容器格式动态选择播放内核
self.player.decoder = [SGPlayerDecoder AVPlayerDecoder];    // 仅使用 AVPlayer
self.player.decoder = [SGPlayerDecoder FFmpegDecoder];      // 仅使用 FFmpeg

// 单个容器格式单独配置示例
self.player.decoder.decodeTypeForMPEG4 = SGDecoderTypeFFmpeg;      // 使用 FFmpeg 播放 mp4 文件

// 开启 FFmpeg 硬解
self.player.decoder.hardwareAccelerateEnableForFFmpeg = YES;

// 进入 VR眼镜 模式
self.player.displayMode = SGDisplayModeBox;

// 设置后台播放模式
// 如果需要后台播放,需将项目的 Background Modes 打开并勾选 Audio 选项, 并将 AVAudioSession 的 Category 设为AVAudioSessionCategoryPlayback
self.player.backgroundMode = SGPlayerBackgroundModeAutoPlayAndPause;  // 自动暂停及恢复
self.player.backgroundMode = SGPlayerBackgroundModeContinue;          // 继续播放

演示

iOS

  • Plane video


  • 360° panorama video

SGPlayer

选择将代码托管在码云
你还在等什么

可能是中国最大最好的代码托管平台


大家对 SGPlayer 的评论 (全部 1 条评论)
{{repayCom.userName}}
顶部