MPMediaItem Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
A single piece of media, such as a song or video.
[Foundation.Register("MPMediaItem", true)]
public class MPMediaItem : MediaPlayer.MPMediaEntity[Foundation.Register("MPMediaItem", true)]
public class MPMediaItem : Foundation.NSObject, Foundation.INSSecureCoding, IDisposable[<Foundation.Register("MPMediaItem", true)>]
type MPMediaItem = class
inherit MPMediaEntity[<Foundation.Register("MPMediaItem", true)>]
type MPMediaItem = class
inherit NSObject
interface INSCoding
interface INativeObject
interface IDisposable
interface INSSecureCoding- Inheritance
- Inheritance
- Attributes
- Implements
Remarks
Instances of this object expose high-level properties that can be consumed from C# to explore the metadata associated with this media item.
Media Items have persistent identifiers that can be used as unique identifiers across application launches and as long as the media item has not been changed or synchronized again with the host computer. The PersistentID is the persistent ID for the media item. There are also persistent identifiers for the album, the composer, podcast, genre and artists.
For low-level access to the metadat, this class exposes the low-level ValueForProperty(NSString) method and various static properties with the suffix "Property" and the return type NSString.
Constructors
| Name | Description |
|---|---|
| MPMediaItem() |
Creates a new MPMediaItem with default values. |
| MPMediaItem(NativeHandle) |
A constructor used when creating managed representations of unmanaged objects. Called by the runtime. |
| MPMediaItem(NSCoder) |
A constructor that initializes the object from the data stored in the unarchiver object. |
| MPMediaItem(NSObjectFlag) |
Constructor to call on derived classes to skip initialization and merely allocate the object. |
Properties
| Name | Description |
|---|---|
| AccessibilityAttributedUserInputLabels | (Inherited from NSObject) |
| AccessibilityRespondsToUserInteraction | (Inherited from NSObject) |
| AccessibilityTextualContext | (Inherited from NSObject) |
| AccessibilityUserInputLabels | (Inherited from NSObject) |
| AlbumArtist |
The Album's artist |
| AlbumArtistPersistentID |
The Album's Artist Persistent ID |
| AlbumArtistPersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyAlbumArtistPersistentID |
| AlbumArtistProperty |
Represents the value associated with the constant MPMediaItemPropertyAlbumArtist |
| AlbumPersistentID |
The Album's persistent id |
| AlbumPersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyAlbumPersistentID |
| AlbumTitle |
The album title |
| AlbumTitleProperty |
Represents the value associated with the constant MPMediaItemPropertyAlbumTitle |
| AlbumTrackCount |
The album track count |
| AlbumTrackCountProperty |
Represents the value associated with the constant MPMediaItemPropertyAlbumTrackCount |
| AlbumTrackNumber |
The album track |
| AlbumTrackNumberProperty |
Represents the value associated with the constant MPMediaItemPropertyAlbumTrackNumber |
| Artist |
The artist |
| ArtistPersistentID |
The Artist Persistent ID |
| ArtistPersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyArtistPersistentID |
| ArtistProperty |
Represents the value associated with the constant MPMediaItemPropertyArtist |
| Artwork |
The artwork |
| ArtworkProperty |
Represents the value associated with the constant MPMediaItemPropertyArtwork |
| AssetURL |
The asset URL |
| AssetURLProperty |
Represents the value associated with the constant MPMediaItemPropertyAssetURL |
| BeatsPerMinute |
The beats per minute |
| BeatsPerMinuteProperty |
Represents the value associated with the constant MPMediaItemPropertyBeatsPerMinute |
| BookmarkTime |
The user bookmark time |
| BookmarkTimeProperty |
Represents the value associated with the constant MPMediaItemPropertyBookmarkTime |
| Class | (Inherited from NSObject) |
| ClassHandle |
The Objective-C class handle for this class. |
| Comments |
The comments |
| CommentsProperty |
Represents the value associated with the constant MPMediaItemPropertyComments |
| Composer |
The composer |
| ComposerPersistentID |
The Composer Persistent ID |
| ComposerPersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyComposerPersistentID |
| ComposerProperty |
Represents the value associated with the constant MPMediaItemPropertyComposer |
| DateAdded | |
| DateAddedProperty |
The value that is associated with the MPMediaItemPropertyDateAdded constant. |
| DebugDescription | (Inherited from NSObject) |
| Description | (Inherited from NSObject) |
| DiscCount |
The number of discs in the album that contains this media item. |
| DiscCountProperty |
Represents the value associated with the constant MPMediaItemPropertyDiscCount |
| DiscNumber |
The disc number |
| DiscNumberProperty |
Represents the value associated with the constant MPMediaItemPropertyDiscNumber |
| ExposedBindings | (Inherited from NSObject) |
| Genre |
The genre. |
| GenrePersistentID |
The Genre Persistent ID |
| GenrePersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyGenrePersistentID |
| GenreProperty |
Represents the value associated with the constant MPMediaItemPropertyGenre |
| Handle |
Handle (pointer) to the unmanaged object representation. (Inherited from NSObject) |
| HasProtectedAsset | |
| HasProtectedAssetProperty |
The value that is associated with the MPMediaItemPropertyHasProtectedAsset constant. |
| IsCloudItem |
Determines if the item is an iCloud item or not. |
| IsCloudItemProperty |
Represents the value associated with the constant MPMediaItemPropertyIsCloudItem |
| IsCompilation |
Set to true if this is media item belongs to a compilation. |
| IsCompilationProperty |
Represents the value associated with the constant MPMediaItemPropertyIsCompilation |
| IsDirectBinding | (Inherited from NSObject) |
| IsExplicitItem | |
| IsExplicitProperty |
The value that is associated with the MPMediaItemPropertyIsExplicit constant. |
| IsPreorder | |
| IsPreorderProperty |
Represents the value associated with the constant 'MPMediaItemPropertyIsPreorder'. |
| IsProxy | (Inherited from NSObject) |
| LastPlayedDate |
The last date that this item was played. |
| LastPlayedDateProperty |
Represents the value associated with the constant MPMediaItemPropertyLastPlayedDate |
| Lyrics |
The lyrics. |
| LyricsProperty |
Represents the value associated with the constant MPMediaItemPropertyLyrics |
| MediaType |
Media type for this media item. |
| MediaTypeProperty |
Represents the value associated with the constant MPMediaItemPropertyMediaType |
| PersistentID |
The Persistent ID |
| PersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyPersistentID |
| PlaybackDuration |
Playback duration in seconds. |
| PlaybackDurationProperty |
Represents the value associated with the constant MPMediaItemPropertyPlaybackDuration |
| PlaybackStoreID |
Gets the non-library ID. |
| PlaybackStoreIDProperty |
Backing store for the PlaybackStoreID property. |
| PlayCount |
Number of times this item has been played. |
| PlayCountProperty |
Represents the value associated with the constant MPMediaItemPropertyPlayCount |
| PodcastPersistentID |
The Podcast Persistent ID. |
| PodcastPersistentIDProperty |
Represents the value associated with the constant MPMediaItemPropertyPodcastPersistentID |
| PodcastTitle |
Title for the podcast. |
| PodcastTitleProperty |
Represents the value associated with the constant MPMediaItemPropertyPodcastTitle |
| PropertyPersistentID |
The value that is associated with the MPMediaEntityPropertyPersistentID constant. |
| Rating |
The user assigned rating in the range zero to five. |
| RatingProperty |
Represents the value associated with the constant MPMediaItemPropertyRating |
| ReleaseDate |
The release date for this media item. |
| ReleaseDateProperty |
Represents the value associated with the constant MPMediaItemPropertyReleaseDate |
| RetainCount | (Inherited from NSObject) |
| Self | (Inherited from NSObject) |
| SkipCount |
Number of times this item has been skipped from playing back. |
| SkipCountProperty |
Represents the value associated with the constant MPMediaItemPropertySkipCount |
| Superclass | (Inherited from NSObject) |
| SuperHandle |
Handle used to represent the methods in the base class for this NSObject. (Inherited from NSObject) |
| Title |
The title for this media item. |
| TitleProperty |
Represents the value associated with the constant MPMediaItemPropertyTitle |
| UserGrouping |
User defined grouping for this media item. |
| UserGroupingProperty |
Represents the value associated with the constant MPMediaItemPropertyUserGrouping |
| Zone | (Inherited from NSObject) |