▶️ video player in Swift, simple way to play and stream media on iOS/tvOS
Clone or download
Pull request Compare This branch is 2 commits ahead, 117 commits behind piemonte:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Player.xcworkspace
Project
Sources
docs
.gitignore
.swift-version
.travis.yml
LICENSE
Package.swift
Player.gif
Player_iOS8.podspec
README.md
build_docs.sh

README.md

Player

Player

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

Build Status Pod Version Swift Version GitHub license

Features

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

Quick Start

Player is available for installation using the Cocoa dependency manager CocoaPods. Alternatively, you can simply copy the Player.swift file into your Xcode project.

Xcode 8 & Swift 3

# CocoaPods
swift_version = "3.0"
pod "Player", "~> 0.5.0"

# Carthage
github "piemonte/Player" ~> 0.5.0

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.addChildViewController(self.player)
 self.view.addSubview(self.player.view)
 self.player.didMoveToParentViewController(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: NSURL = // file or http url
self.player.setUrl(videoUrl)

play/pause/chill

 self.player.playFromBeginning()

Adjust the fill mode for the video, if needed.

 self.player.fillMode = 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

Resources

License

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