General Media Item Property Keys

System defined properties used to obtain the metadata for a media item.

Overview

Obtain metadata for a media item by calling the valueForProperty: method with these property keys. Some properties can be used to build media property predicates, as described in MPMediaPropertyPredicate. These properties are marked here as filterable.

Topics

Filterable by MPMediaPropertyPredicate Queries

MPMediaItemPropertyAlbumArtist

The primary performing artist for an album as a whole.

MPMediaItemPropertyAlbumArtistPersistentID

The persistent identifier for an album artist.

MPMediaItemPropertyAlbumPersistentID

The key for the persistent identifier for an album.

MPMediaItemPropertyAlbumTitle

The title of an album.

MPMediaItemPropertyArtist

The performing artist(s) for a media item—which may vary from the primary artist for the album that a media item belongs to.

MPMediaItemPropertyArtistPersistentID

The key for the persistent identifier for an artist.

MPMediaItemPropertyComposer

The musical composer for the media item.

MPMediaItemPropertyComposerPersistentID

The persistent identifier for a composer.

MPMediaItemPropertyGenre

The musical or film genre of the media item.

MPMediaItemPropertyGenrePersistentID

The persistent identifier for a genre.

MPMediaItemPropertyHasProtectedAsset

A Boolean value indicating the media item is wrapped in DRM and can not be used through a standard playback API.

MPMediaItemPropertyIsCompilation

A Boolean value indicating whether the media item is part of a compilation.

MPMediaItemPropertyIsCloudItem

A Boolean value indicating whether the media item is an iCloud item.

MPMediaItemPropertyMediaType

The media type of the media item.

MPMediaItemPropertyPersistentID

The key for the persistent identifier for the media item.

MPMediaItemPropertyPlayCount

The number of times the user has played the media item.

MPMediaItemPropertyPodcastPersistentID

The persistent identifier for an audio podcast.

MPMediaItemPropertyPodcastTitle

The title of a podcast.

MPMediaItemPropertyTitle

The title (or name) of the media item.

Not Filterable by MPMediaPropertyPredicate Queries

MPMediaItemPropertyPlaybackDuration

The playback duration of the media item.

MPMediaItemPropertyAlbumTrackNumber

The track number of the media item, for a media item that is part of an album.

MPMediaItemPropertyAlbumTrackCount

The number of tracks in the album that contains the media item.

MPMediaItemPropertyDiscNumber

The disc number of the media item, for a media item that is part of a multi-disc album.

MPMediaItemPropertyDiscCount

The number of discs in the album that contains the media item.

MPMediaItemPropertyArtwork

The artwork image for the media item.

MPMediaItemPropertyLyrics

The lyrics for the media item.

MPMediaItemPropertyReleaseDate

The date on which the media item was first publicly released.

MPMediaItemPropertyBeatsPerMinute

The number of musical beats per minute for the media item, corresponding to the “BPM” field in the Info tab in the Get Info dialog in iTunes.

MPMediaItemPropertyComments

Textual information about the media item, corresponding to the “Comments” field in the Info tab in the Get Info dialog in iTunes.

MPMediaItemPropertyAssetURL

A URL pointing to the media item, from which an AVAsset object (or other URL-based AVFoundation object) can be created, with any options as desired.

MPMediaItemPropertyIsExplicit

A Boolean value indicating whether the media item contains explicit content.

MPMediaItemPropertyPlaybackStoreID

The identifier used to enqueue store tracks.

See Also

Media Item Types and Keys

MPMediaType

The properties used to define the type for a media item.

User-Defined Property Keys

Contains properties used to obtain user-defined metadata for a media item.