Captions

Overview

People can create custom styles for caption appearance in Accessibility settings. The Media Accessibility framework provides access to these user-captioning settings.

In macOS, choose System Settings > Accessibility > Captions to access these options.

[Image]

When a person creates a custom caption style, the settings affect attributes, such as caption color, font, and language.

[Image]

By choosing custom styles for media text, people are requesting improved legibility. The Media Accessibility functions let you to tailor the user experience of your media content. You must be able to influence the caption-rendering process at time of delivery for the following functions to be useful. Retrieving a person’s preferences and dynamically rendering the captions for maximum readability provides the best user experience.

Topics

General settings

• kMACaptionAppearanceSettingsChangedNotification
• MACaptionAppearanceDidDisplayCaptions(_:)
• MACaptionAppearanceCopyPreferredCaptioningMediaCharacteristics(_:)
• MACaptionAppearanceGetDisplayType(_:)
• MACaptionAppearanceSetDisplayType(_:_:)

Language settings

• MACaptionAppearanceAddSelectedLanguage(_:_:)
• MACaptionAppearanceCopySelectedLanguages(_:)

Text settings

• MACaptionAppearanceCopyFontDescriptorForStyle(_:_:_:)
• MACaptionAppearanceCopyForegroundColor(_:_:)
• MACaptionAppearanceGetForegroundOpacity(_:_:)
• MACaptionAppearanceGetRelativeCharacterSize(_:_:)
• MACaptionAppearanceGetTextEdgeStyle(_:_:)

Text highlight settings

• MACaptionAppearanceCopyBackgroundColor(_:_:)
• MACaptionAppearanceGetBackgroundOpacity(_:_:)

Caption window settings

• MACaptionAppearanceCopyWindowColor(_:_:)
• MACaptionAppearanceGetWindowOpacity(_:_:)
• MACaptionAppearanceGetWindowRoundedCornerRadius(_:_:)

Image captioning settings

• MAImageCaptioningCopyCaption(_:_:)
• MAImageCaptioningSetCaption(_:_:_:)
• MAImageCaptioningCopyMetadataTagPath()

Audible media selection settings

• kMAAudibleMediaSettingsChangedNotification
• MAAudibleMediaCopyPreferredCharacteristics()
• MAMediaCharacteristicDescribesVideoForAccessibility
• MAMediaCharacteristicDescribesMusicAndSoundForAccessibility
• MAMediaCharacteristicTranscribesSpokenDialogForAccessibility

Profile settings

• MACaptionAppearanceCopyProfileIDs()
• MACaptionAppearanceSetActiveProfileID(_:)
• MACaptionAppearanceCopyActiveProfileID()
• MACaptionAppearanceCopyProfileName(_:)
• MACaptionAppearanceExecuteBlockForProfileID(_:_:)

Customization status

• MACaptionAppearanceIsCustomized(_:)

Constants

• MACaptionAppearanceDomain
• MACaptionAppearanceDisplayType
• MACaptionAppearanceBehavior
• MACaptionAppearanceFontStyle
• MACaptionAppearanceTextEdgeStyle

See Also

Features

• Flashing lights
• Music Haptics