GSPlayer

<p align="center"> <a href="https://developer.apple.com/swift"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/f9ab0ade-4233-4099-b9dd-22c4b02636e6.svg?style=flat"></a> <a href="https://developer.apple.com/ios"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/79809cb7-d1b0-4648-a35c-6793839a2d4d.svg?style=flat"></a> <a href="http://cocoadocs.org/docsets/GSPlayer"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/a7460923-36f4-4aed-84d5-d11582a9d364.svg?style=flat"></a> <a href="https://github.com/wxxsw/GSPlayer/blob/master/LICENSE"><img src="https://yellow-cdn.veclightyear.com/0a4dffa0/4c92dea7-1af1-4b1b-b13e-0f82b0da86ea.svg?style=flat"></a> </p>

特性

• 完全可自定义的UI。
• 易用的API和回调。
• 内置缓存机制支持边下载边播放（mp4）。
• 可随时预加载多个视频。
• 可嵌入UITableView和UICollectionView中。
• 提供全屏过渡。
• 完整的演示。

快速开始

1. 将VideoPlayerView添加到界面。

let playerView = VideoPlayerView()
view.addSubview(playerView)

// 或在IB中，将自定义View的类型指定为VideoPlayerView。

2. 播放视频。

playerView.play(for: someURL)

3. 暂停/恢复视频。

if playerView.state == .playing {
    playerView.pause(reason: .userInteraction)
} else {
    playerView.resume()
}

4. 根据播放状态更新控制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许可证