An elegant wraper API for AVPlayer to get events over Delegate so you dount need to use KVO


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

pod "PlayerView"


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

source ''
platform :iOS, '8.0'

pod 'PlayerView'


Installation is also available using the dependency manager Carthage.

To integrate, add the following line to your Cartfile:

github "davidlondono/PlayerView" >= 0.2.7

Swift Package Manager

Installation can be done with the Swift Package Manager, add the following in your Package.swift :

import PackageDescription

let package = Package(
    name: "PlayerView",
    dependencies: [
        .Package(url: "", majorVersion: 0),


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


Just add a view and add as a class on Identity inspector > Custom Class > Class, make sure to add Module if is imported externaly (Pod, Package manager ....)

import PlayerView
@IBOutlet var playerVideo: PlayerView!


Just need to add de view as a normal View:

import PlayerView

let playerVideo = PlayerVideo()

//also could add frame:
// let playerVideo = PlayerVideo(frame: frame)


//set aspect mode of video
//default AVLayerVideoGravityResizeAspectFill
playerVideo.fillMode = .ResizeAspect

//Set or Get the seconds of the current time of reproduction
//this will set to reproduce on 3.5 seconds
playerVideo.currentTime = 3.5

//define the time interval to get callback delegate of the current time of reproduction, default sends 60 times on 1 second
//default CMTimeMake(1, 60)
//this send the time one time per one second
playerVideo.interval = CMTimeMake(1, 1)

//set and get the speed of reproduction
//if speed is set to 0, the video will pause (same as playerVideo.pause())
//if speed is set to 1,0, the video will pause (same as
playerVideo.rate = 0.5

//play the video at rate 1.0

// pause the video on current time

// stop the video on current time

// stop the video on current time

//to set the url of Video
if let url = NSURL(string: "") {
	playerVideo.url = url
    playerVideo.urls = [url]

    //add videos on queue
    playerVideo.addVideosOnQueue(urls: [url])

//Take a screenshot on time, and return time to ensure the tolerance of the image
//on 20.7 seconds
let(image1, time1) = playerVideo.screenshotTime(20.7)
//on actual time
let(image2, time2) = playerVideo.screenshotTime()

//on actual time
let image3 = playerVideo.screenshot()

//reset queue and observers


you could get event data from the PlayerView, just implement the delegate
all the functions are optionals

import PlayerView
import AVFoundation
	playerVideo.delegate = self

extension MyClass:PlayerViewDelegate {

	func playerVideo(player: PlayerView, statusPlayer: PlayerViewStatus, error: NSError?) {
        //got the status of the player
		//useful to know if is ready to play
		//if status is unknown then got the error

	func playerVideo(player: PlayerView, statusItemPlayer: PlayerViewItemStatus, error: NSError?) {
		//some status got here first, this is the status of AVPlayerItem
		//useful to know if is ready to play
		//if status is unknown then got the error

	func playerVideo(player: PlayerView, loadedTimeRanges: [PlayerviewTimeRange]) {
		//got the buffer of the video
		//to know the progress loaded

		//this will get the seconds of the end of the buffer


	func playerVideo(player: PlayerView, duration: Double) {
		//the player knows the duration of the video to reproduce on seconds

	func playerVideo(player: PlayerView, currentTime: Double) {
		//executed using the playerVideo.interval
        //only executed when the is reproducing, on pause (rate == 1) this doesn't execute
		//default executed like 60 frames per seconds, so 60 times on a second

	func playerVideo(player: PlayerView, rate: Float) {
		//if the speed of reproduction changed by pausing, playing or changing speed

    func playerVideo(playerFinished player: PlayerView) {
        //when the video finishes the reproduction to the end

Extra Info

  • If you like another shorcut, have a better implementation of something or just say thanks, just send me an email [[email protected]](mailto:[email protected]?subject=PlayerView is Awesome)

  • Im using a video on http, so I needed to add this on the info.plist to accept all on http,
    this is not safe to use on production, so better to add only trusted domains or use https

    <!--Include to allow all connections (DANGER)-->


David Alejandro, [[email protected]](mailto:[email protected]?subject=PlayerView is Awesome)


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