<!--
{
  "availability" : [
    "iOS: 12.0.0 -",
    "iPadOS: 12.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.14.0 -",
    "tvOS: 12.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVPlayerMediaSelectionCriteria/init(principalMediaCharacteristics:preferredLanguages:preferredMediaCharacteristics:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVPlayerMediaSelectionCriteria(im)initWithPrincipalMediaCharacteristics:preferredLanguages:preferredMediaCharacteristics:"
  },
  "title" : "init(principalMediaCharacteristics:preferredLanguages:preferredMediaCharacteristics:)"
}
-->

# init(principalMediaCharacteristics:preferredLanguages:preferredMediaCharacteristics:)

Creates media selection criteria with the principal media characteristics, and preferred languages and media characteristics.

```
init(principalMediaCharacteristics: [AVMediaCharacteristic]?, preferredLanguages: [String]?, preferredMediaCharacteristics: [AVMediaCharacteristic]?)
```

## Parameters

`principalMediaCharacteristics`

An array of media characteristics that are essential to selecting media with the characteristic. This value may be `nil`.

`preferredLanguages`

An array of language identifier strings, in order of preference. This value may be `nil`.

`preferredMediaCharacteristics`

An array of media characteristics, in order of preference. This value may be `nil`.

## Discussion

Principal media characteristics, when present, override language preferences when making selections within a specific media selection group. However, language preferences may still pertain to selections in other groups. For example, the system may consider language preferences when choosing whether to select nonforced subtitles for translation purposes.

---

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)