Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


DVPlaylistPlayer is an easy-to-use AVQueuePlayer-like player with wider capabilities. It is built on top of the AVPlayer. Unlike AVQueuePlayer here you have all the basic player controls like moving to next or previous video, mute, unmute or change volume level and so on. Another difference with AVQueuePlayer is in non-regular way of setting the list of tracks. This player takes it's tracks from data source like UITableView. Detailed implementation and usage information provided in our blog -

##Required frameworks##

  • MediaPlayer
  • AVFoundation
  • AudioToolbox

##Adding DVPlaylistPlayer to your project## ###CocoaPods### The easiest way to add our playlist player to your project is to use CocoaPods. If you don't have CocoaPods installed on your system, then we suggest you to check for further information. All you need to do to install DVPlaylistPlayer is to create file named 'Podfile' right in your project.xcodeproj file directory. Then you need to add next two lines:

platform :ios, '5.0' //depends on your project requirments but not less pod 'DVPlaylistPlayer', :git=>''

Then you enter magic words to your console: pod install

and DVPlaylistPlayer will be automatically downloaded and installed to your project. All the frameworks required for player will also be added automatically. Just don't forget to use Workspace file instead of *.xcodeproj from now!

###Source files### The other way is to add source files to your project directly by copying them. Here is the algorithm.

  • Clone this repository or download zip archive with SDK.
  • Open your project in XCode and drag-and-drop all files from directory 'DVPlaylistPlayer' to your project.
  • import class DVPlaylistPlayer.h to any implementation or header file where you want to use it.

##Usage## DVPlaylistPlayer is really easy to use. All you need to start playing media is to create an instance:

self.playlistPlayer = [[DVPlaylistPlayer alloc] init];

Provide it with the data source:

self.playlistPlayer.dataSource = some id<DVPlaylistPlayerDataSource>;

And play:

[self.playlistPlayer playMediaWithIndex:0];

That is all. Data source takes AVPlayerItem files in it's method and passes it to player. DVPlaylistPlayer does all the player setup for you. Playlist player have all the regular player controls as methods. Here's the list.

  • playMediaWithIndex:
  • resume
  • pause
  • stop
  • next
  • previous
  • setVolume
  • mute
  • unmute

Additionally you can receive events about playing state changes and set a periodic time observer. To receive events you just have to set the 'delegate' property on player. Delegate object must correspond to protocol DVPlaylistPlayerDelegate. To set a periodic time observer you must call method addPeriodicTimeObserverForInterval:queue:usingBlock:. Also if you need to have an access to the AVPlayer instance that is lying at the heart of DVPlaylistPlayer - you're welcome. It is in public interface.

##Requirements## DVPlaylistPlayer requires iOS 5.0 as minimum OS version. This project uses ARC.