---
title: MPMediaItemCollection
framework: mediaplayer
role: symbol
role_heading: Class
path: mediaplayer/mpmediaitemcollection
---

# MPMediaItemCollection

A sorted set of media items from the media library.

## Declaration

```swift
class MPMediaItemCollection
```

## Overview

Overview Typically, you use this class by requesting an array of collections from a media query by way of its collections property. MPMediaQuery describes media queries. The grouping type for the media query determines the arrangement of the media items you obtain. You also use the media query collections property to obtain synced playlists, as described in MPMediaPlaylist. A media item collection can have a wide range of metadata associated with it. You access this metadata using the value(forProperty:) method along with the property keys described in this document. You can also access metadata in a batch fashion using the enumerateValues(forProperties:using:) method. In some cases, this is more efficient. MPMediaEntity defines and describes both of these methods.

## Topics

### Creating a media item collection

- [init(items:)](mediaplayer/mpmediaitemcollection/init(items:).md)

### Using a media item collection

- [items](mediaplayer/mpmediaitemcollection/items.md)
- [representativeItem](mediaplayer/mpmediaitemcollection/representativeitem.md)
- [count](mediaplayer/mpmediaitemcollection/count.md)
- [mediaTypes](mediaplayer/mpmediaitemcollection/mediatypes.md)

## Relationships

### Inherits From

- [MPMediaEntity](mediaplayer/mpmediaentity.md)

### Inherited By

- [MPMediaPlaylist](mediaplayer/mpmediaplaylist.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Media items and playlists

- [Providing animated artwork for media items](mediaplayer/providing-animated-artwork-for-media-items.md)
- [MPMediaItem](mediaplayer/mpmediaitem.md)
- [MPMediaItemArtwork](mediaplayer/mpmediaitemartwork.md)
- [MPMediaItemAnimatedArtwork](mediaplayer/mpmediaitemanimatedartwork.md)
- [MPMediaPlaylist](mediaplayer/mpmediaplaylist.md)
- [MPMediaPlaylistCreationMetadata](mediaplayer/mpmediaplaylistcreationmetadata.md)
- [MPMediaEntity](mediaplayer/mpmediaentity.md)