GithubHelp home page GithubHelp logo

aawayne / plplayerkit Goto Github PK

View Code? Open in Web Editor NEW

This project forked from pili-engineering/plplayerkit

0.0 1.0 0.0 457.24 MB

PLPlayerKit 是七牛推出的一款免费的适用于 iOS 平台的播放器 SDK，采用全自研的跨平台播放内核，拥有丰富的功能和优异的性能，可高度定制化和二次开发。

Home Page: https://developer.qiniu.com/pili/sdk/1211/ios-playback-end-the-sdk

License: Apache License 2.0

Objective-C 88.43% Ruby 1.10% C 0.75% Shell 9.72%

plplayerkit's Introduction

PLPlayerKit

PLPlayerKit 是一个适用于 iOS 的音视频播放器 SDK，可高度定制化和二次开发，特色是支持 RTMP, HTTP-FLV 和 HLS 直播流媒体播放。

功能特性

  • 高可定制
  • 直播累积延迟消除技术
  • 支持首屏秒开
  • 支持 RTMP 直播流播放
  • 支持 HTTP-FLV 直播流播放
  • 支持 HLS 播放
  • 支持 HTTPS 播放
  • 支持多种画面预览模式
  • 支持画面旋转与镜像
  • 支持播放器音量设置
  • 支持纯音频播放
  • 支持后台播放
  • 支持使用 IP 地址的 URL
  • 支持软硬解自动切换
  • 支持 H.265 格式播放
  • 支持 HLS 七牛私有 DRM
  • 支持点播倍速播放
  • 支持点播 mp4 视频本地缓存播放
  • 支持 SEI 数据回调
  • 支持 rtmp 原始时间戳
  • 支持 flv 使用 mp3 音频格式
  • 支持 http 的 DNS 异步解析
  • 支持视频根据旋转角度自动旋转

说明

从 v3.0.0 开始，SDK 全面升级为七牛完全自研的播放器内核，拥有更加优异的性能，升级内容如下：

  • 新增倍数播放功能（0.5x，1x，2x，4x 等）
  • 新增 mp4 本地缓存功能
  • 新增 HLS 七牛私有 DRM 的支持
  • 新增 H.265 格式播放的支持
  • 优化 CPU、内存和功耗
  • 优化首开效果，首开速度有大幅提升
  • 优化重连逻辑，不用销毁播放器，网络断开后内部自动重连
  • 优化 mp4 点播，使用双 IO 技术更高效地播放 moov 在尾部的 mp4 文件
  • 支持播放过程中变速不变调，可实现更平滑的追帧效果，更少的卡顿率
  • 新增支持 SEI 数据回调，更多数据交互

内容摘要

快速开始

配置工程

CocoaPods 导入

  • 配置你的 Podfile 文件，添加如下配置信息
pod 'PLPlayerKit'
  • 安装 CocoaPods 依赖
pod update

or

pod install
  • Done! 运行你工程的 workspace

手动导入

  • 将 Pod 目录下的所有文件加入到工程中；
  • 添加 HappyDNS 库，把 链接 中的 HappyDNS 目录下的所有文件加入到工程中
  • Build Setting 下 Other Linker Flags 中添加 -ObjC
  • Build Phases 下 Link Binary With Libraries 中添加如图所示

示例代码

在需要的地方添加

#import <PLPlayerKit/PLPlayerKit.h>

初始化 PLPlayerOption

// 初始化 PLPlayerOption 对象
PLPlayerOption *option = [PLPlayerOption defaultOption];

// 更改需要修改的 option 属性键所对应的值
[option setOptionValue:@15 forKey:PLPlayerOptionKeyTimeoutIntervalForMediaPackets];
[option setOptionValue:@2000 forKey:PLPlayerOptionKeyMaxL1BufferDuration];
[option setOptionValue:@1000 forKey:PLPlayerOptionKeyMaxL2BufferDuration];
[option setOptionValue:@(NO) forKey:PLPlayerOptionKeyVideoToolbox];
[option setOptionValue:@(kPLLogInfo) forKey:PLPlayerOptionKeyLogLevel];

初始化 PLPlayer

// 初始化 PLPlayer
self.player = [PLPlayer playerWithURL:self.URL option:option];

// 设定代理 (optional)
self.player.delegate = self;

获取播放器的视频输出的 UIView 对象并添加为到当前 UIView 对象的 Subview

//获取视频输出视图并添加为到当前 UIView 对象的 Subview
[self.view addSubview:player.playerView];

开始／暂停操作

// 播放
[self.player play];

// 停止
[self.player stop];

// 暂停
[self.player pause];

// 继续播放
[self.player resume];

播放器状态获取

// 实现 <PLPlayerDelegate> 来控制流状态的变更
- (void)player:(nonnull PLPlayer *)player statusDidChange:(PLPlayerStatus)state {
	// 这里会返回流的各种状态，你可以根据状态做 UI 定制及各类其他业务操作
	// 除了 Error 状态，其他状态都会回调这个方法
  // 开始播放，当连接成功后，将收到第一个 PLPlayerStatusCaching 状态
  // 第一帧渲染后，将收到第一个 PLPlayerStatusPlaying 状态
  // 播放过程中出现卡顿时，将收到 PLPlayerStatusCaching 状态
  // 卡顿结束后，将收到 PLPlayerStatusPlaying 状态
}

- (void)player:(nonnull PLPlayer *)player stoppedWithError:(nullable NSError *)error {
	// 当发生错误，停止播放时，会回调这个方法
}

- (void)player:(nonnull PLPlayer *)player codecError:(nonnull NSError *)error {
  // 当解码器发生错误时，会回调这个方法
  // 当 videotoolbox 硬解初始化或解码出错时
  // error.code 值为 PLPlayerErrorHWCodecInitFailed/PLPlayerErrorHWDecodeFailed
  // 播发器也将自动切换成软解，继续播放
}

音频部分的特别说明

因为 iOS 的音频资源被设计为单例资源，所以如果在 player 中做的任何修改，对外都可能造成影响，并且带来不能预估的各种问题。

为了应对这一情况，PLPlayerKit 采取的方式是检查是否可以播放及是否可以进入后台，而在内部不做任何设置。具体是通过扩展 AVAudioSession 来做到的，提供了两个方法，如下：

/*!
 * @description 检查当前 AVAudioSession 的 category 配置是否可以播放音频. 当为 AVAudioSessionCategoryAmbient,
 * AVAudioSessionCategorySoloAmbient, AVAudioSessionCategoryPlayback, AVAudioSessionCategoryPlayAndRecord
 * 中的一种时为 YES, 否则为 NO.
 */
+ (BOOL)isPlayable;

/*!
 * @description 检查当前 AVAudioSession 的 category 配置是否可以后台播放. 当为 AVAudioSessionCategoryPlayback,
 * AVAudioSessionCategoryPlayAndRecord 中的一种时为 YES, 否则为 NO.
 */
+ (BOOL)canPlayInBackground;

分辨可以检查是否可以播放以及当前 category 的设置是否可以后台播放。

其它依赖库版本号

  • FFmpeg : v3.3.x
  • OpenSSL: OpenSSL_1_1_0f
  • Speex: v1.2.0

版本历史

  • 3.2.0 (Release Notes && API Diffs)
  • 功能
    • 支持 flv 使用 mp3 音频格式
    • 支持 http 的 DNS 异步解析
    • 支持视频根据旋转角度自动旋转
  • 缺陷
    • 修复失去音频第一帧渲染问题
    • 修复 OpenGL crash 的问题
    • 修复部分视频音画不同步的问题
    • 修复部分视频花屏、马赛克的问题
    • 修复弱网播放偶现快速切换卡顿的问题
    • 修复进入后台切换第三方应用 crash 的问题
    • 解决由第三方引起的 ffmpeg 冲突问题
    • 修复直播 url 中含有 ?domain= 无法播放的问题
    • 修复音频视频时长不匹配 resume 播放失败的问题
  • 3.1.0 (Release Notes && API Diffs)
  • 功能
    • 支持读取 mp3, aac 格式
    • 支持读取 rtmp 流中的音视频时间戳信息
    • 支持读取视频旋转角度参数
    • 支持 mpeg 格式播放
  • 缺陷
    • 修复 Stop 时偶现的 Crash 及卡住的问题
    • 修复 ipv6 rtmp 无法播放的问题
    • 修复播放纯音频/纯视频流时得不到 playing 状态的问题
    • 修复特定 flv 流重复播放的问题
    • 修复偶现 OpenGL crash 的问题
  • 3.0.2 (Release Notes && API Diffs)
  • 功能
    • 加长 URL 设置长度
  • 缺陷
    • 修复 iPhone X 模拟器崩溃问题
    • 修复数据缓存回调总时长出错问题
    • 修复截图功能无效问题
    • 修复 OpenGL 崩溃问题
    • 修复无法修改 playerView 的 bounds 属性的问题
  • 3.0.1 (Release Notes && API Diffs)
  • 功能
    • 新增 SEI 数据回调
    • 新增播放格式预设置
    • 新增同格式快速播放接口
  • 缺陷
    • 修复播放器错误时收不到 error 状态回调的问题
    • 修复某些 mp4 无法播放的问题
    • 修复多次 stop 时 crash 的问题
  • 3.0.0 (Release Notes && API Diffs)
  • 全面升级为七牛自研的播放器内核，拥有更优异的性能
  • 功能
    • 新增 HLS 七牛私有 DRM 的支持
    • 新增 H.265 格式的播放
    • 新增点播倍速播放
    • 新增点播 mp4 视频缓存播放
  • 优化
    • 优化包体大小
    • 优化 CPU、内存和功耗
    • 优化直播模式下的追帧策略，效果更加平滑
    • 优化重连逻辑，不用销毁播放器，网络断开后内部自动重连
    • 优化 mp4 点播，使用双 IO 技术更高效地播放 moov 在尾部的 mp4 文件
  • 2.4.3 (Release Notes && API Diffs)
  • 功能
    • 新增流分辨率变化的通知
    • 新增提供更多音视频信息的回调接口
    • 新增首开耗时接口
    • 增强 FFmpeg 点播硬解兼容性
  • 缺陷
    • 修复 AVPlayer 点播 pause 状态切换时播放器状态异常的问题
    • 修复 FFmpeg 点播纯音频流时 seek 失败的问题
    • 修复硬解在某些场景下出现绿屏的问题
  • 2.4.2 (Release Notes && API Diffs)
  • 缺陷
    • 修复 AVPlayer 播放时调用 pause 和设置 frame 无效的问题
    • 修复解码器释放时线程并发导致的偶发 crash
  • 2.4.1 (Release Notes && API Diffs)
  • 功能
    • 新增 probesize 参数配置
    • 新增播放器初始化后更新 URL 的接口
    • 新增 AVPlayer 点播的缓冲进度接口
    • 增加 http header 中 referer 自定义接口
  • 缺陷
    • 修复锁屏且屏幕黑后，播放没有声音的问题
    • 修复播放器释放时偶发的 crash
  • 2.4.0 (Release Notes && API Diffs)
  • 功能
    • 新增 https 支持
    • 新增文件播放
    • 新增 speex, ogg 等音视频格式， avi, m4a 等封装格式支持。
    • 新增 display aspect ratio 信息
    • 新增 DNS 预解析接口
    • 新增开播前封面图
  • 缺陷
    • 修复一些偶发的 crash
  • 2.3.0 (Release Notes && API Diffs)
  • 功能
    • 新增直播流画面旋转模式
    • 新增直播流分辨率信息
    • 新增停止渲染的选项
    • 新增基于 FFMPEG 的点播
  • 缺陷
    • 修复一些偶现的 crash
  • 优化
    • 优化开始播放的快进时间
  • 2.2.4 (Release Notes && API Diffs)
  • 缺陷
    • 修复与 CocoaLumberjack 符号冲突的问题
  • 2.2.3 (Release Notes && API Diffs)
  • 功能
    • 新增 QoS 功能
    • 新增渲染数据回调
    • 新增截图功能
    • 新增 MP3 后台播放
  • 缺陷
    • 修复后台播放时，触发超时重连，丢失 sps/pps，回到前台画面停住，声音正常的问题
    • 修复 RTMP 扩展时间戳的问题
    • 修复播放器释放阻塞主线程的问题
    • 优化音视频同步机制
    • 优化 caching 状态检查
  • 2.2.2 (Release Notes && API Diffs)
  • 功能
    • 新增 AAC HEV2 音频支持
    • 新增 SDK 自动重连功能，默认不开启
  • 缺陷
    • 修复长时间播放偶发解码 crash
    • 修复 pause/resmue 快速调用导致 crash
    • 修复重连未更换服务器 IP
    • 修复 rtmp 硬解播放视频抖动
    • 修复 flv 开始播放偶发黑屏
    • 修复 flv 超时机制失效
  • 2.2.1 (Release Notes && API Diffs)
  • 功能
    • 支持 SDK 日志级别设置
    • 新增 HappyDNS 支持
  • 缺陷
    • 修复回看状态不准确问题
    • 修复跳转第三方应用，出现内存增加
    • 修复播放卡住 caching 状态
  • 2.2.0 (Release Notes && API Diffs)
  • 功能
    • 新增硬解功能
    • 新增 http-flv 支持
    • 新增 iOS9 下的纯 IPV6 环境支持
  • 缺陷
    • 修复快速进入退出黑屏
  • 优化
    • 追帧策略优化
    • 退出后台停止视频解码
  • 2.1.3 (Release Notes && API Diffs)
    • 增加设置一级缓存和二级缓存的选项，便于控制卡顿率
    • 修复播放 OBS 及 FFmpeg 推的流黑屏的问题
    • 修复播放结束后无法重播的问题
    • 修复播放过程中内存暴增的问题
    • 拆分 pili-librtmp 为公共依赖，解决模拟器环境下与 PLStreamingKit 冲突的问题
  • 2.1.2 (Release Notes && API Diffs)
    • 增加确切的错误枚举，方便定位错误类型
    • 增加 mute, currentTime, totalDuration, seekTo 等接口
    • 修复首屏开启以及播放过程中出现缓存后网络恢复是可能出现的 UI 卡顿问题
    • 修复 contentMode 偶尔设置无效的问题
    • 修复重新设置播放 url 播放的问题
    • 修复快速 -stop 以及 -play 出现的内存泄露问题
  • 2.1.1 (Release Notes && API Diffs)
    • 首屏开启速度优化，在网络状况良好的情况下能实现秒开效果
    • 弱网情况下的累积延迟问题优化，较好控制累积延迟在数秒以内
    • 解决了上一版遇到的无法设置 playerView.contentMode 以及 playerOption 的问题
    • 解决了不标准流可能出现的音频断续，播放器内存异常增长问题
    • 后台播放体验优化，修复了后台播放被其他音频打断后出现的一系列问题
    • 解决了应用切换时出现的 UI 卡死问题
  • 2.1.0 (Release Notes && API Diffs)
    • 此次更新为重大版本升级，更改了大量 API 并重构了包括解码渲染在内的多项内容，建议所有用户进行升级，并且根据快速开始使用新版 API 对工程重新进行配置。
    • 更改了播放器的音频解码和渲染方式
    • 更改了播放器的时钟同步机制
    • 重构了内部逻辑，使播放器更稳定
    • 重构了播放器 API ，使播放器的使用更加简单明了，去除了使用起来不方便的部分 API
    • 解决了播放过程中可能出现声音消失的问题
    • 解决了退后台返回后音视频无法正常同步的问题
    • 修改播放器音视频同步机制
    • 解决持续播放过程中出现部分内存没有正确释放的问题
    • 解决了 iOS 版本小于 8.0 时 Demo 出现的crash问题
  • 2.0.4 (Release Notes && API Diffs)
    • 解决 RTMP 播放时可能黑屏的问题
  • 2.0.3 (Release Notes && API Diffs)
    • 解决 RTMP 播放没有声音
    • 解决 RTMP 无法播放导致内存急增最终 App crash
    • 解决 RTMP 无法播放画面只有声音
    • 解决播放 RTMP 时相关的 crash 问题
  • 2.0.2 (Release Notes && API Diffs)
    • 添加 RTMP Cache 机制
    • 添加数据超时属性
    • 修复 RTMP 播放内存 leak
    • 修复 RTMP 播放音频错误问题
    • 修复 RTMP 播放主线程卡死问题
    • 优化架构，减少内存和 cpu 占用
  • 2.0.1 (Release Notes && API Diffs)
    • 修复 contentMode 设置无效的问题
    • 修复 rtmp 无法播放或播放超时时无 error 抛出的问题
    • 修复 rtmp 播放失败时触发的 cpu 飙升问题
    • 修复 stop 可能触发的 crash 问题
    • 更新 demo 确保在 iOS 9.1 下运行正常
  • 2.0.0 (Release Notes && API Diffs)
    • 添加全新的 PLPlayer，弃用 PLVideoPlayerController 和 PLAudioPlayerController
    • 播放 RTMP 音视频流时，进入后台后声音继续播放，不会断开，返回前台追帧显示最新视频帧
    • 针对 RTMP 直播彻底优化，首屏秒开，最小化缓存
    • 完全无 ffmpeg 依赖，包体积再次缩小
    • 优化资源占用，比 1.x 版本内存占用减少 50% 以上
  • 1.2.22 (Release Notes && API Diffs)
    • 修复因收到内存警告而引起的崩溃问题
    • 修复停止播放时，可能进入错误 play state 的问题
  • 1.2.21 (Release Notes && API Diffs)
    • 修复 PLVideoParameterFrameViewContentMode 与 PLVideoParameterDisableDeinterlacing 设置无效的问题
  • 1.2.20 (Release Notes && API Diffs)
    • 修复 seekTo: 不准确的问题
    • 添加 PLPlayerStateSeeking 类型
  • 1.2.19 (Release Notes && API Diffs)
    • 修复播放无返回状态的问题（针对无直播的流、hls 回放）
    • 修复 hls 回放结束时无 stopped 回调的问题
    • 修复 hls 回放开始的 duration 不为 0 的问题
  • 1.2.18 (Release Notes && API Diffs)
    • 修复在 prepare 状态前释放 player 导致的音频仍然会播放的问题
    • 修复 player 状态返回的类型不正确的问题
    • 优化推出时资源释放
  • 1.2.17 (Release Notes && API Diffs)
    • 修复超时时导致的崩溃的问题
  • 1.2.16 (Release Notes && API Diffs)
    • 添加了音频播放器后台播放的支持
    • 添加了音频播放器后台播放任务开始和结束的回调
    • 添加了音视频播放器超时时长的设定
    • 添加了音视频播放器准备的方法
    • 添加了音视频完全停止播放器的方法
    • 修复播放器不可释放的问题
  • 1.2.15 (Release Notes && API Diffs)
    • 修复 AudioPlayer 无法播放带有视频流的 RTMP 流的问题
  • 1.2.14 (Release Notes && API Diffs)
    • 添加 AudioManager
  • 1.2.13 (Release Notes && API Diffs)
    • 添加纯音频播放控件
    • 更新参数字段及类型，确保通用类型可以在音频及视频播放器使用
    • 更新类型名称，增加易读性，减少歧义
  • 1.2.12 (Release Notes && API Diffs)
    • 更改 repo 地址
  • 1.2.11 (Release Notes && API Diffs)
    • 添加对应用状态的判断，减少因进入后台通知延时未能及时暂停播放导致的 crash
  • 1.2.10 (Release Notes && API Diffs)
    • 添加音频外设更改时的通知
    • 添加音量变更时的通知
    • 添加打进电话等其他事件导致音频中断的通知
  • 1.2.9 (Release Notes && API Diffs)
    • 修复进入后台后崩溃的问题
    • 更新 example 中 player 代码，支持横竖屏旋转操作
  • 1.2.8 (Release Notes && API Diffs)
    • 添加播放进度回调方法
    • 修复 seekTo 后流状态不正确的问题
  • 1.2.7 (Release Notes && API Diffs)
    • 添加播放器状态属性
    • 添加解码器初始化完成后回调
    • 添加播放器状态回调
    • 添加初始化后自动播放参数
  • 1.2.6 (Release Notes && API Diffs)
    • 添加设置播放位置的操作
    • 添加了快进、快退的操作
    • 添加总播放时长的属性
    • 添加获取音量的属性
    • 添加获取当前播放位置的属性
    • 添加静音操作
  • 1.2.5 (Release Notes && API Diffs)
    • 修复与部分其他库头文件冲突的问题
  • 1.2.4 (Release Notes && API Diffs)
    • 添加了 PLMovieParameterFrameViewContentMode 参数
    • 修复与部分其他库头文件冲突的问题
    • 修复 Player contentMode 无法更改的问题
  • 1.2.3 (Release Notes && API Diffs)
    • 修复初始化占用主线程导致卡顿的问题
    • 修复错误回调无效的问题
  • 1.2.2 (Release Notes && API Diffs)
    • 修复 lib 未更新导致的 crash
  • 1.2.1 (Release Notes && API Diffs)
    • 添加 failue 情况下的回调，返回 NSError 对象
    • 移除 PLVideoPlayerViewController，请直接使用 PLVideoPlayerController 进行定制
  • 1.2.0 (Release Notes && API Diffs)
    • 极大缩小 lib 大小
    • 增加可定制的播放控件 PLVideoPlayerController
  • 1.1.2
    • 拆分 Flat lib
    • 添加了 x86_64 支持，便于在 iPhone 6 Plus 模拟器下调试使用
  • 1.1.1
    • 对库引用做了些修改
  • 1.1.0
    • 发布 CocoaPods 版本

plplayerkit's People

Contributors

betallcoffee avatar lawder avatar kivenhaoyu avatar longbai avatar herashowfeng avatar wickedgenius avatar why404 avatar depthlove avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.