<!--
{
  "availability" : [
    "iOS: 3.0.0 -",
    "iPadOS: 3.0.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MediaPlayer",
  "identifier" : "/documentation/MediaPlayer/MPMediaPropertyPredicate",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Media Player"
    ],
    "preciseIdentifier" : "c:objc(cs)MPMediaPropertyPredicate"
  },
  "title" : "MPMediaPropertyPredicate"
}
-->

# MPMediaPropertyPredicate

A set of predicates for defining a filter in a media query.

```
class MPMediaPropertyPredicate
```

## Overview

Use one or more `MPMediaPropertyPredicate` objects to define the filter in a media query to retrieve a subset of media items from the Music library. A predicate in this context is a statement of a logical condition that you want to test each media item against. The query retrieves the items that satisfy that condition.

You define Music library queries, and retrieve query results, using the [`MPMediaQuery`](/documentation/MediaPlayer/MPMediaQuery) class. [`MPMediaItem`](/documentation/MediaPlayer/MPMediaItem) and [`MPMediaItemCollection`](/documentation/MediaPlayer/MPMediaItemCollection) describe the media items and media item collections that you can retrieve with a query.

## Topics

### Creating media property predicates

[`+  predicateWithValue:forProperty:`](/documentation/MediaPlayer/MPMediaPropertyPredicate/init(value:forProperty:))

Creates a media property predicate with the default comparison type.

[`+  predicateWithValue:forProperty:comparisonType:`](/documentation/MediaPlayer/MPMediaPropertyPredicate/init(value:forProperty:comparisonType:))

Creates a media property predicate with a specified comparison type.

### Examining media property predicates

[`property`](/documentation/MediaPlayer/MPMediaPropertyPredicate/property)

The property that the media property predicate uses when you invoke a query.

[`value`](/documentation/MediaPlayer/MPMediaPropertyPredicate/value)

The value that the media property predicate matches against when you invoke a query.

[`comparisonType`](/documentation/MediaPlayer/MPMediaPropertyPredicate/comparisonType)

The type of matching comparison that the media property predicate performs when you invoke a query.

### Supporting types

[`MPMediaPredicateComparison`](/documentation/MediaPlayer/MPMediaPredicateComparison)

Logical comparison types for media queries.

## Relationships

### Conforms To

[`NSCoding`](/documentation/Foundation/NSCoding)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

### Inherits From

[`MPMediaPredicate`](/documentation/MediaPlayer/MPMediaPredicate)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)