Instance Method

selectMediaOption:inMediaSelectionGroup:

Selects a media option in a given media selection group and deselects all other options in that group.

Declaration

- (void)selectMediaOption:(AVMediaSelectionOption *)mediaSelectionOption inMediaSelectionGroup:(AVMediaSelectionGroup *)mediaSelectionGroup;

Parameters

mediaSelectionOption

The option to select.

If the value of the allowsEmptySelection property of mediaSelectionGroup is YES, you can pass nil to deselect all media selection options in the group.

mediaSelectionGroup

The media selection group, obtained from the receiver's asset, that contains mediaSelectionOption.

Discussion

If mediaSelectionOption isn’t a member of the mediaSelectionGroup, no change in presentation state will result.

If multiple options within a group meet your criteria for selection according to locale or other considerations, and if these options are otherwise indistinguishable to you according to media characteristics that are meaningful for your application, content is typically authored so that the first available option that meets your criteria is appropriate for selection.

See Also

Selecting Media Options

currentMediaSelection

The current media selections for each of the receiver's media selection groups.

- selectMediaOptionAutomaticallyInMediaSelectionGroup:

Selects the media option in the specified media selection group that best matches the receiver’s automatic selection criteria.

externalSubtitleOptionLanguages

An array of BCP 47 language codes that supplements the list of subtitle options to be presented to the user.

Deprecated
selectedExternalSubtitleOptionLanguage

The BCP 47 language code of the external subtitle option language marked in the user interface.

Deprecated
- selectedMediaOptionInMediaSelectionGroup:

Returns the media selection option that's currently selected from the specified group.

Deprecated