Player

Player

Player is a simple iOS/tvOS video player library written in Swift.

• Looking for an obj-c video player? Check out PBJVideoPlayer (obj-c).
• Looking for a Swift camera library? Check out Next Level.

Need a different version of Swift?

• 5.0 - Target your Podfile to the latest release or master
• 4.2 - Target your Podfile to the swift4.2 branch
• 4.0 - Target your Podfile to the swift4.0 branch

Features

• plays local media or streams remote media over HTTP
• customizable UI and user interaction
• no size restrictions
• orientation change support
• simple API
• video frame snapshot support

Quick Start

Player is available for installation using Swift Package Manager, CocoaPods, or by manually copying the Player.swift file into your Xcode project.

Swift Package Manager

Add Player to your Package.swift dependencies:

dependencies: [
    .package(url: "https://github.com/piemonte/Player.git", from: "0.15.0")
]

Or add it directly in Xcode via File > Add Package Dependencies and enter the repository URL.

CocoaPods

pod "Player", "~> 0.15.0"

Manual Installation

Simply copy the Player.swift file from the Sources directory into your Xcode project.

Usage

The sample project provides an example of how to integrate Player, otherwise you can follow these steps.

Allocate and add the Player controller to your view hierarchy.

 self.player = Player()
 self.player.playerDelegate = self
 self.player.playbackDelegate = self
 self.player.view.frame = self.view.bounds

 self.addChild(self.player)
 self.view.addSubview(self.player.view)
 self.player.didMove(toParent: self)

Provide the file path to the resource you would like to play locally or stream. Ensure you're including the file extension.

let videoUrl: URL = // file or http url
self.player.url = videoUrl

For HTTP streams with custom headers, use AVAsset:

let videoUrl: URL = // http url
let headers = ["Authorization": "Bearer token123"]
let asset = AVURLAsset(url: videoUrl, options: ["AVURLAssetHTTPHeaderFieldsKey": headers])
self.player.asset = asset

For iCloud Photos or PHAsset videos, use AVPlayerItem:

let playerItem: AVPlayerItem = // your player item
self.player.playerItem = playerItem

play/pause

 self.player.playFromBeginning()

Adjust the fill mode for the video, if needed.

 self.player.fillMode = .resizeAspectFit

Display video playback progress, if needed.

extension ViewController: PlayerPlaybackDelegate {

    public func playerPlaybackWillStartFromBeginning(_ player: Player) {
    }

    public func playerPlaybackDidEnd(_ player: Player) {
    }

    public func playerCurrentTimeDidChange(_ player: Player) {
        let fraction = Double(player.currentTime) / Double(player.maximumDuration)
        self._playbackViewController?.setProgress(progress: CGFloat(fraction), animated: true)
    }

    public func playerPlaybackWillLoop(_ player: Player) {
        self. _playbackViewController?.reset()
    }

}

Documentation

You can find the docs here. Documentation is generated with jazzy and hosted on GitHub-Pages.

Community

• Need help? Use Stack Overflow with the tag 'player-swift'.
• Questions? Use Stack Overflow with the tag 'player-swift'.
• Found a bug? Open an issue.
• Feature idea? Open an issue.
• Want to contribute? Submit a pull request.

Resources

• Swift Evolution
• AV Foundation Programming Guide
• Next Level, rad media capture in Swift
• PBJVision, iOS camera engine, features touch-to-record video, slow motion video, and photo capture
• PBJVideoPlayer, a simple iOS video player library, written in obj-c

License

Player is available under the MIT license, see the LICENSE file for more information.