---
title: "loadMediaSelectionGroup(for:completionHandler:)"
framework: avfoundation
role: symbol
role_heading: Instance Method
path: "avfoundation/avasset/loadmediaselectiongroup(for:completionhandler:)"
---

# loadMediaSelectionGroup(for:completionHandler:)

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

## Declaration

```swift
func loadMediaSelectionGroup(for mediaCharacteristic: AVMediaCharacteristic, completionHandler: @escaping @Sendable (AVMediaSelectionGroup?, (any Error)?) -> Void)
```

```swift
func loadMediaSelectionGroup(for mediaCharacteristic: AVMediaCharacteristic) async throws -> AVMediaSelectionGroup?
```

## Parameters

- `mediaCharacteristic`: A media characteristic to load the available media selection options for. The supported characterisics are: 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 doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/legible to return the group of available options for subtitles in various languages and for various purposes doc://com.apple.avfoundation/documentation/AVFoundation/AVMediaCharacteristic/visual to return the group of available options for video media
- `completionHandler`: A callback that the system invokes after it finishes the loading request. It passes the completion handler the following parameters:

## See Also

### Loading media selections

- [allMediaSelections](avfoundation/avpartialasyncproperty/allmediaselections.md)
- [preferredMediaSelection](avfoundation/avpartialasyncproperty/preferredmediaselection.md)
- [availableMediaCharacteristicsWithMediaSelectionOptions](avfoundation/avpartialasyncproperty/availablemediacharacteristicswithmediaselectionoptions.md)