/VersaPlayer

Versatile Video Player implementation for iOS, macOS, and tvOS

Primary LanguageSwiftMIT LicenseMIT

CI Status Version License Platform

News

🎉 - Since 2.1.3 VersaPlayer now supports iOS, macOS, and tvOS

  1. Example
  2. Installation
  3. Usage
    1. Basic Usage
    2. Adding Controls
    3. Advanced Usage
      1. Encrypted Content (Digital Rights Management)
      2. Track Selection
        1. Audio Tracks
        2. Video Tracks
        3. Caption Tracks
          1. Caption Styling
  4. Extensions
    1. Airplay Extension
    2. Ads Extension
    3. Overlay Content Extension
  5. Documentation
  6. Awesome People (Contributors)
  7. Donation

Community

If you have any doubts or need help with anything, head over to Gitter and ask it there!

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

IMPORTANT: If you do not have an Apple ID with a developer account for code signing apps, the build will fail with a code signing error. To work around this, you can delete the "Code Signing Identity" build setting of the "Application" target to work around the issue.

Alternatively, if you do have a developer account, you can create the file "Examples/Xcode-config/DEVELOPMENT_TEAM.xcconfig" with the following build setting as its content:

DEVELOPMENT_TEAM = [Your TeamID]

For a more detailed description of this, you can have a look at the comments at the end of the file "Examples/Xcode-config/Base.xcconfig".

Installation

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

VersaPlayer is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'VersaPlayer'

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate Alamofire into your Xcode project using Carthage, specify it in your Cartfile:

github "josejuanqm/VersaPlayer" "3.0.0"

Usage

Basic Usage

VersaPlayer aims to be simple to use but also flexible, to start using VersaPlayer first create a view programatically or via storyboard. Then add this few lines of code to start playing your video.

    @IBOutlet weak var playerView: VersaPlayerView!

    override func viewDidLoad() {
        super.viewDidLoad()
        if let url = URL.init(string: "http://rmcdn.2mdn.net/Demo/html5/output.mp4") {
            let item = VersaPlayerItem(url: url)
            playerView.set(item: item)
        }
    }

Adding Controls

To add controls for your player use the VersaPlayerControls class, which comes packed with outlets to control your player, you can also add as many as you like by making a custom implementation.

VersaPlayerControls class include the following outlets:

Outlet Name Type Action
playPauseButton VersaStatefullButton Toggle playback
fullscreenButton VersaStatefullButton Toggle fullscreen mode
pipButton VersaStatefullButton Toggle PIP mode in supported devices
rewindButton VersaStatefullButton Rewind playback
forwardButton VersaStatefullButton Fast forward playback
skipForwardButton VersaStatefullButton Skip forward the time specified in second at skipSize (found in VersaPlayerControls)
skipBackwardButton VersaStatefullButton Skip backward the time specified in second at skipSize (found in VersaPlayerControls)
seekbarSlider VersaSeekbarSlider Seek through playback
currentTimeLabel VersaTimeLabel Indicate the current time
totalTimeLabel VersaTimeLabel Indicate the total time
bufferingView UIView Shown when player is buffering
    @IBOutlet weak var playerView: VersaPlayerView!
    @IBOutlet weak var controls: VersaPlayerControls!

    override func viewDidLoad() {
        super.viewDidLoad()
        playerView.use(controls: controls)
        if let url = URL.init(string: "http://rmcdn.2mdn.net/Demo/html5/output.mp4") {
            let item = VersaPlayerItem(url: url)
            playerView.set(item: item)
        }
    }

Advanced Usage

DRM

VersaPlayer also brings support for encrypted content, to make use of this functionality you must implement VersaPlayerDecryptionDelegate and assign it to VersaPlayer's decryptionDelegate property.

To read more about this topic go to:

https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Protocols/VersaPlayerDecryptionDelegate.html

Tracks

To make use of different media tracks, such as audio, video, or captioning, use VersaPlayerMediaTracks, found in VersaPlayer class.

to learn more about this properties go to:

https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Classes/VersaPlayerMediaTrack.html

Audio Tracks

Audio tracks are specially helpfull when dealing with different languages, for example for a movie playback.

To select an audio track simply fetch available tracks with VersaPlayer's audioTracks property.

    @IBOutlet weak var playerView: VersaPlayer!

    ...
    
    let tracks: [VersaPlayerMediaTrack] = playerView.player.currentItem?.audioTracks
    /// the name of the track
    let name = tracks.first?.name
    /// the language of the track
    let name = tracks.first?.language
    /// selecting the first one
    tracks.first?.select(for: playerView.player)
Video Tracks

Video tracks are most helpfull when dealing with different renditions or different streams per video quality.

To select an video track simply follow the same principles as an audio track.

    @IBOutlet weak var playerView: VersaPlayer!

    ...
    
    let tracks: [VersaPlayerMediaTrack] = playerView.player.currentItem?.videoTracks
    /// the name of the track
    let name = tracks.first?.name
    /// selecting the first one
    tracks.first?.select(for: playerView.player)
Caption Tracks

Caption tracks are almost always helpfull. This can be used from a movie playback all the way to assitive content.

To select an video track simply follow the same principles as video and audio tracks.

    @IBOutlet weak var playerView: VersaPlayer!

    ...
    
    let tracks: [VersaPlayerMediaTrack] = playerView.player.currentItem?.captionTracks
    /// the name of the track
    let name = tracks.first?.name
    /// the language of the track
    let name = tracks.first?.language
    /// selecting the first one
    tracks.first?.select(for: playerView.player)
Caption Styling

Caption styling are not usually managed by the user, but when necessary, captionStyling property from VersaPlayer comes in handy.

Explore all the available attributes that can be changed here:

https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Classes/VersaPlayerCaptionStyling.html

Extensions

Versa is aimed to be versatile, and that's why it comes with an extensions feature, that lets you customize any aspect of the player by inheriting from VersaPlayerExtension.

This class comes with a player attribute that points to the player instance from which is being used. To add an extension use the add(extension ext:) method found in https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/Classes/VersaPlayer.html.

Here are some extensions for VersaPlayer that may be useful for you.

  1. AirPlay Extension

  2. Ads Extension

  3. Overlay Content Extension

Documentation

Full documentation avilable https://josejuanqm.github.io/Libraries-Documentation/VersaPlayerCore/

Author

Jose Quintero - jose.juan.qm@gmail.com

Contributors

People that make VersaPlayer possible, Thank you!

josejuanqm pbeast danibachar HuseyinVural

Donation

If you like this project or has been helpful to you, you can buy me a cup of coffe :) Appreciate it!

paypal

License

VersaPlayer is available under the MIT license. See the LICENSE file for more info.