#mpmediaitem

In this tutorial we will have a look at how to use MediaPlayer framework to play music from your app. To begin with we need to#import <MediaPlayer/MediaPlayer.h>. There are three core classes that we will work with.

MPMusicPlayerController There are two types of MPMusicPlayerController

Application music player ([MPMusicPlayerController applicationMusicPlayer]) that plays music just in your app and does not affect the in-built iPod

iPod music player ([MPMusicPlayerController iPodMusicPlayer]) that employs the in-built iPod to play music - the music can be controlled in the iPod app and remains playing even after you quit your app

MPMusicPlayerController methods are quite self-explanatory:

- setQueueWithQuery: and - setQueueWithItemCollection are used to set playback queue with query (see below)

- play, - pause, - stop, - beginSeekingForward, - beginSeekingBackward, - endSeeking, - skipToNextItem, - skipToPreviousItem, - skipToBeginning are all used to control the player

currentPlaybackTime, nowPlayingItem, playbackState, repeatMode, shuffleMode, volume are all properties of the player that you can use to change the behavior or display different attributes

MPMediaItem MPMediaItem is a single item in the media library (such as one song). It is the nowPlayingItem property of the player. Each item has metadata associated with it, those can be accessed by calling valueForProperty: method. The full list of properties can be found in thedocumentation but some examples include MPMediaItemPropertyTitle or MPMediaItemPropertyArtist.

MPMediaQuery MPMediaQuery is used to do queries in the iPod library. Again, the full description is best to be found in the documentation but a little example demonstrates how MPMediaQuery works.

MPMediaQuery* query = [MPMediaQuery songsQuery]; [query addFilterPredicate:[MPMediaPropertyPredicate predicateWithValue:@"The Beatles" forProperty:MPMediaItemPropertyArtist comparisonType:MPMediaPredicateComparisonEqualTo]]; [query setGroupingType:MPMediaGroupingAlbum];

This creates a query that selects all songs whose artist is "The Beatles" and groups them by album. All the songs in the query can be passed to MPMusicPlayerController to play.

Example Now put it all together: