MPNowPlayingInfoCenterMBS.defaultCenter as MPNowPlayingInfoCenterMBS

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

Returns the singleton Now Playing info center.

The default now playing info center holds Now Playing information for the app that’s designated to receive remote control events.

MPNowPlayingInfoCenterMBS.MediaItemPropertyAlbumTitle as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The title of an album.
This value property contains the album title, such as “Live On Mars”, as opposed to the title of an individual song on the album, such as “Crater Dance (radio edit)” (which you specify using the MPMediaItemPropertyTitle property). Value is a string.

MPNowPlayingInfoCenterMBS.MediaItemPropertyAlbumTrackCount as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The number of tracks for the album that contains the media item.
This value is an UInteger. For an audio streaming app, the system provides a default value of 1 for this property.

MPNowPlayingInfoCenterMBS.MediaItemPropertyAlbumTrackNumber as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

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

MPNowPlayingInfoCenterMBS.MediaItemPropertyArtist as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

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

For example, if the album artist is “Joseph Fable,” the artist for one of the songs in the album may be “Joseph Fable featuring Thomas Smithson”. Value is a string.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.MediaItemPropertyArtwork as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The artwork image for the media item.
This value is a media item image, described in MPMediaItemArtworkMBS.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.MediaItemPropertyComposer as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The musical composer for the media item.
This value is a string.

MPNowPlayingInfoCenterMBS.MediaItemPropertyDiscCount as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The number of discs for the album that contains the media item.
This value is an UInteger.

MPNowPlayingInfoCenterMBS.MediaItemPropertyDiscNumber as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The disc number of the media item, for a media item that is part of a multidisc album.
This value is an UInteger.

MPNowPlayingInfoCenterMBS.MediaItemPropertyGenre as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The music or film genre of the media item.
This value is a string.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.MediaItemPropertyMediaType as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The media type of the media item.
This value is an Integer. The integer value represents a bit field flag, or set of flags, from MPMediaType.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.MediaItemPropertyPersistentID as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The key for the persistent identifier for the media item.

The corresponding value is a number that contains a MPMediaEntityPersistentID. The value of the MPMediaItemPropertyPersistentID identifier persists across application launches and across syncs that do not change the sync status of the media item. The value is not guaranteed to persist across a sync/unsync/sync cycle.

MPNowPlayingInfoCenterMBS.MediaItemPropertyPlaybackDuration as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The duration. Value is a double.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.MediaItemPropertyTitle as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the media property keys.

The title or name of the media item.
This property is unrelated to the MPMediaItemPropertyAlbumTitle property. Value is a string.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.NowPlayingInfoCollectionIdentifier as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

An identifier that represents the collection to which the now playing item belongs. This can refer to an artist, album, playlist, etc. This can be used to ask the now playing app to resume playback of the collection.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyAdTimeRanges as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A list of ad breaks in the now playing item.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyAssetURL as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A URL pointing to the now playing item's underlying audio/video asset. This property is used by system UI when video thumbnails or audio waveform visualizations are applicable.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyAvailableLanguageOptions as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A list of available language option groups in the now playing item Only one language option in a given group can be played at once.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyChapterCount as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The total number of chapters in the now playing item.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyChapterNumber as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The chapter currently being played. Note that this is zero-based.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyCreditsStartTime as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

Represents the credits start time (without ads) in seconds for the now playing item.
A replacement for MPNowPlayingInfoPropertyPlaybackProgress.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyCurrentLanguageOptions as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A list of currently active language options in the now playing item.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyCurrentPlaybackDate as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

Represents the real-time date associated with the current elapsed playback time.

The value of an AVPlayerItem’s currentDate property can be used to populate this property (see AVFoundation framework.) Note the current playback date will be automatically extrapolated from the previously provided current playback date, so updating this property frequently is not required (nor recommended.) For example, a sports broadcast can map an elapsed playback time (i.e 12 minutes and 30 seconds) to a real-time date (i.e "10:30:00 9/14/2017")

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyDefaultPlaybackRate as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The "default" playback rate of the now playing item. You should set this property if your app is playing a media item at a rate other than 1.0 in a default playback state. e.g., if you are playing back content at a rate of 2.0 and your playback state is not fast-forwarding, then the default playback rate should also be 2.0. Conversely, if you are playing back content at a normal rate (1.0) but the user is fast-forwarding your content at a rate greater than 1.0, then the default playback rate should be set to 1.0.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyElapsedPlaybackTime as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The elapsed time of the now playing item, in seconds.
Note the elapsed time will be automatically extrapolated from the previously provided elapsed time and playback rate, so updating this property frequently is not required (or recommended.)

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyExcludeFromSuggestions as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A boolean denoting whether the now playing item should be excluded from content suggestions.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyExternalContentIdentifier as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

An opaque identifier that uniquely represents the now playing item, even across app relaunches. This can be in any format and is only used to reference this item back to the now playing app.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyExternalUserProfileIdentifier as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

An optional opaque identifier that uniquely represents the profile that the now playing item is being played from, even across app relauches. This can be in any format and is only used to reference this profile back to the now playing app.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyInternationalStandardRecordingCode as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

Represents the International Standard Recording Code (ISRC) for a song, if available. This will be used by system services that leverage now playing data, such as Music Haptics.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyIsLiveStream as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A boolean denoting whether the now playing item is a live stream.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyMediaType as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

Indicates the media type of the now playing item This can be used to determine what kind of user interface the system displays.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyPlaybackProgress as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

Represents the current playback progress of the now playing item. 0.0 = not watched/listened/viewed, 1.0 = fully watched/listened/viewed This value is different that ElapsedPlaybackTime and does not need to be exact as it is used as a high level indicator as to how far along the user is. For example, a movie may wish to set the now playing item as fully watched when the credits begin to roll.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyPlaybackQueueCount as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The total number of items in the application's playback queue.

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyPlaybackQueueIndex as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The index of the now playing item in the application's playback queue. Note that the queue uses zero-based indexing, so the index of the first item would be 0 if the item should be displayed as "item 1 of 10".

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyPlaybackRate as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

The playback rate of the now playing item, with 1.0 representing normal playback. For example, 2.0 would represent playback at twice the normal rate.
If not specified, assumed to be 1.0.

Some examples using this method:

• /AVFoundation/AudioPlayer

MPNowPlayingInfoCenterMBS.NowPlayingInfoPropertyServiceIdentifier as String

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
shared method	MediaPlayer	MBS iOS Plugin	25.0	✅ Yes	❌ No	❌ No	✅ Yes	All

One of the dictionary keys for now playing.

A unique string that identifies a service provider. If the now playing item belongs to a channel or subscription service, this key can be used to coordinate various types of now playing content from a particular service provider.