carabina / player Goto Github PK

Player

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

Features

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

If you're looking for a video player library written in Objective-C, checkout PBJVideoPlayer. For video recording, checkout PBJVision.

Installation

CocoaPods

Player is available and recommended for installation using the Cocoa dependency manager CocoaPods. Swift is supported as of version 0.36.

To integrate, add the following to your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :iOS, '8.0'
use_frameworks!

pod 'Player'

Carthage

Installation is also available using the dependency manager Carthage.

To integrate, add the following line to your Cartfile:

github "piemonte/Player" >= 0.0.5

Manual

You can also simply copy the Player.swift file 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.delegate = 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 = “AVLayerVideoGravityResizeAspect”

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

• AV Foundation Programming Guide
• PBJVision, iOS camera engine, features touch-to-record video, slow motion video, and photo capture
• PBJVideoPlayer, a simple iOS video player library, written in Objective-C
• objc.io Issue #16, Swift

License

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