特性
- 完全可自定义的UI。
- 易用的API和回调。
- 内置缓存机制支持边下载边播放(mp4)。
- 可随时预加载多个视频。
- 可嵌入UITableView和UICollectionView中。
- 提供全屏过渡。
- 完整的演示。
快速开始
- 将
VideoPlayerView
添加到界面。
let playerView = VideoPlayerView()
view.addSubview(playerView)
// 或在IB中,将自定义View的类型指定为VideoPlayerView。
- 播放视频。
playerView.play(for: someURL)
- 暂停/恢复视频。
if playerView.state == .playing {
playerView.pause(reason: .userInteraction)
} else {
playerView.resume()
}
- 根据播放状态更新控制UI。
playerView.stateDidChanged = { state in
switch state {
case .none:
print("无")
case .error(let error):
print("错误 - \(error.localizedDescription)")
case .loading:
print("加载中")
case .paused(let playing, let buffering):
print("已暂停 - 进度 \(Int(playing * 100))% 缓冲 \(Int(buffering * 100))%")
case .playing:
print("播放中")
}
}
文档
缓存
获取视频缓存的总大小。
VideoCacheManager.calculateCachedSize()
清理所有缓存。
VideoCacheManager.cleanAllCache()
预加载
设置要预加载的视频URL。预加载会自动缓存视频开头的一小段,并根据当前播放视频的缓冲情况决定是否开始或暂停预加载。
VideoPreloadManager.shared.set(waiting: [URL])
设置预加载大小,默认值为1024 * 1024,单位为字节。
VideoPlayer.preloadByteCount = 1024 * 1024 // = 1M
全屏
参见演示。
PlayerView
属性
管理播放器视觉输出的对象。
public let playerLayer: AVPlayerLayer { get }
获取当前视频状态。
public enum State {
/// 无
case none
/// 从第一次加载到获取视频第一帧
case loading
/// 正在播放
case playing
/// 暂停,当缓冲进度改变时会重复调用
case paused(playing: Double, buffering: Double)
/// 发生错误,无法继续播放
case error(NSError)
}
public var state: State { get }
视频暂停的原因。
public enum PausedReason {
/// 因播放器不可见而暂停,缓冲进度改变时不会调用stateDidChanged
case hidden
/// 由用户交互触发的暂停,默认行为
case userInteraction
/// 等待资源完成缓冲
case waitingKeepUp
}
public var pausedReason: PausedReason { get }
重播次数。
public var replayCount: Int { get }
已播放进度,值范围0-1。
public var playing: Double { get }
已播放时长,单位为秒。
public var currentDuration: Double { get }
已缓冲进度,值范围0-1。
public var buffering: Double { get }
已缓冲时长,单位为秒。
public var currentBufferDuration: Double { get }
视频总时长,单位为秒。
public var totalDuration: Double { get }
此视频的总观看时长,单位为秒。
public var watchDuration: Double { get }
视频是否静音,仅对此实例有效。
public var isMuted: Bool { get set }
视频音量,仅对此实例有效。
public var volume: Double { get set }
回调
播放状态改变,如从播放到暂停。
public var stateDidChanged: ((State) -> Void)?
播放到结束后重播。
public var replay: (() -> Void)?
方法
播放指定url的视频。
func play(for url: URL)
暂停视频。
func pause(reason: PausedReason)
继续播放视频。
func resume()
安装
GSPlayer可通过CocoaPods获得。要安装它,只需在你的Podfile中添加以下行:
pod 'GSPlayer'
贡献
问题
如果你发现了bug或需要帮助,可以创建一个issue
拉取请求
我们很高兴接受拉取请求:D。但请确保它是大多数开发者需要的,并且使用起来简单。如果你不确定,可以创建一个issue,我们可以在你开始编码之前讨论它。
许可证
MIT许可证