---
title: "mediaSelectionGroup(forMediaCharacteristic:)"
framework: avfoundation
role: symbol
role_heading: Instance Method
path: "avfoundation/avmutablemovie/mediaselectiongroup(formediacharacteristic:)"
---

# mediaSelectionGroup(forMediaCharacteristic:)

Returns a media selection group that contains one or more options with the specified media characteristic.

## Declaration

```swift
func mediaSelectionGroup(forMediaCharacteristic mediaCharacteristic: AVMediaCharacteristic) -> AVMediaSelectionGroup?
```

## Parameters

- `mediaCharacteristic`: A media characteristic for which to obtain the available media selection options. Only doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/audible, doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/visual, and doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/legible are currently supported. Pass doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/audible to return the group of available options for audio media in various languages and for various purposes, such as descriptive audio. Pass doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/legible to return the group of available options for subtitles in various languages and for various purposes. Pass doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/visual to return the group of available options for video media.

## Return Value

Return Value An AVMediaSelectionGroup that contains one or more options with the specified media characteristic, or nil if none could be found.

## Discussion

Discussion Use the filtering methods AVMediaSelectionGroup defines to filter the group’s options according to playability, locale, and additional media characteristics. You can call this method without blocking the current thread after you’ve asynchronously loaded the availableMediaCharacteristicsWithMediaSelectionOptions property.

## See Also

### Accessing media selections

- [allMediaSelections](avfoundation/avmutablemovie/allmediaselections.md)
- [availableMediaCharacteristicsWithMediaSelectionOptions](avfoundation/avmutablemovie/availablemediacharacteristicswithmediaselectionoptions.md)