Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка на функцию доступности справочных изданий платформы MediaAccessibility

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка на функцию доступности носителей

Функции заголовка Доступности Носителей обеспечивают доступ к пользователю, озаглавливающему предпочтения. И iOS 7 и OS X 10.9 позволяют пользователям создавать пользовательские стили для появления заголовка. Для понимания контекста платформы Доступности Носителей необходимо понять доступные пользовательские настройки. Эти возможности предоставляются в разделе Accessibility приложения Установок системы как показано на рисунке 1. Настройки влияют на атрибуты, такие как цвет заголовка, шрифт и язык. Некоторые варианты показываются на рисунке 2. Путем выбора пользовательских стилей для текста носителей пользователи запрашивают улучшенную четкость.

Предпочтения рисунка 1Accessibility разделяют на области в image: ../Art/SystemPreferences_2x.png
предпочтительной области появления рисунка 2Caption OS X в OS X image: ../Art/CaptionPreferences_2x.png

Функции Доступности Носителей предоставлены для Вас для адаптации пользовательского опыта мультимедийного контента. Необходимо быть в состоянии влиять на процесс рендеринга заголовка во время поставки для следующих функций, чтобы быть полезными. Получение предпочтений пользователя и динамично рендеринг заголовков для максимальной удобочитаемости обеспечивают лучший пользовательский опыт.

Функции

Доступ к общим предпочтениям

Доступ к предпочтениям языка
  • MACaptionAppearanceAddSelectedLanguage (_: _:) MACaptionAppearanceAddSelectedLanguage

    Добавляет предпочтение языка заголовка к штабелю языков.

    Объявление

    Swift

    func MACaptionAppearanceAddSelectedLanguage(_ domain: MACaptionAppearanceDomain, _ language: CFString!) -> Bool

    Objective C

    bool MACaptionAppearanceAddSelectedLanguage ( MACaptionAppearanceDomain domain, CFStringRef language );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    language

    Канонический идентификатор языка (см. Ссылку CFLocale) предпочтительного языка заголовка.

    Возвращаемое значение

    Возвраты true если дополнение было успешно; false если произошла ошибка. Ошибки наиболее вероятны результат недопустимых кодов языка.

    Обсуждение

    Добавленный язык появится в массиве, возвращенном MACaptionAppearanceCopySelectedLanguages. Вызовите MACaptionAppearanceAddSelectedLanguage функционируйте каждый раз, когда пользователь выбирает определенный язык ввода субтитров из всплывающего меню или другой подразумеваемой возможности UI. Например, клиент AVFoundation может выполнить следующий код:

    • // in response to a user selection, make the selection effective
    • -[AVPlayerItem selectMediaOption:legibleOption inMediaSelectionGroup:legibleGroup];
    • // now update system-wide captioning preferences by registering the added language
    • MACaptionAppearanceAddSelectedLanguage(kMACaptionAppearanceDomainUser, (CFStringRef)[[legibleOption locale] localeIdentifier]);

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • MACaptionAppearanceCopySelectedLanguages (_:) MACaptionAppearanceCopySelectedLanguages

    Возвращает предпочтительные языки заголовка.

    Объявление

    Swift

    func MACaptionAppearanceCopySelectedLanguages(_ domain: MACaptionAppearanceDomain) -> Unmanaged<CFArray>!

    Objective C

    CFArrayRef MACaptionAppearanceCopySelectedLanguages ( MACaptionAppearanceDomain domain );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    Возвращаемое значение

    Упорядоченный массив предпочтительных канонических идентификаторов языка.

    Обсуждение

    Языки добавили использование MACaptionAppearanceAddSelectedLanguage функция нормализована. В результате содержание возвращенного массива может иметь немного отличающиеся строки от переданных в MACaptionAppearanceAddSelectedLanguage.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

Доступ к тексту, представляющему предпочтения

Доступ к текстовым предпочтениям выделения
  • MACaptionAppearanceCopyBackgroundColor (_: _:) MACaptionAppearanceCopyBackgroundColor

    Возвращает цвет предпочтения текстового выделения.

    Объявление

    Swift

    func MACaptionAppearanceCopyBackgroundColor(_ domain: MACaptionAppearanceDomain, _ behavior: UnsafeMutablePointer<MACaptionAppearanceBehavior>) -> Unmanaged<CGColor>!

    Objective C

    CGColorRef MACaptionAppearanceCopyBackgroundColor ( MACaptionAppearanceDomain domain, MACaptionAppearanceBehavior *behavior );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    behavior

    Указатель на память. По возврату эта память содержит поведение появления заголовка для этой предпочтительной установки. Поскольку возможные значения видят Поведение Появления Заголовка. Передача NULL когда Вам не нужна установка поведения.

    Возвращаемое значение

    Предпочтительный цвет, показанный позади текста и выше цвета окна.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • MACaptionAppearanceGetBackgroundOpacity (_: _:) MACaptionAppearanceGetBackgroundOpacity

    Возвращает предпочтительную непрозрачность для текстового выделения.

    Объявление

    Swift

    func MACaptionAppearanceGetBackgroundOpacity(_ domain: MACaptionAppearanceDomain, _ behavior: UnsafeMutablePointer<MACaptionAppearanceBehavior>) -> CGFloat

    Objective C

    CGFloat MACaptionAppearanceGetBackgroundOpacity ( MACaptionAppearanceDomain domain, MACaptionAppearanceBehavior *behavior );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    behavior

    Указатель на память. По возврату эта память содержит поведение появления заголовка для этой предпочтительной установки. Поскольку возможные значения видят Поведение Появления Заголовка. Передача NULL когда Вам не нужна установка поведения.

    Возвращаемое значение

    Значение плавающее, в пределах от 0.0 к 1.0, представление непрозрачности цвета позади текста и выше цвета окна.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

Доступ к предпочтениям окна заголовка
  • MACaptionAppearanceCopyWindowColor (_: _:) MACaptionAppearanceCopyWindowColor

    Возвращает предпочтение цвета окна заголовка.

    Объявление

    Swift

    func MACaptionAppearanceCopyWindowColor(_ domain: MACaptionAppearanceDomain, _ behavior: UnsafeMutablePointer<MACaptionAppearanceBehavior>) -> Unmanaged<CGColor>!

    Objective C

    CGColorRef MACaptionAppearanceCopyWindowColor ( MACaptionAppearanceDomain domain, MACaptionAppearanceBehavior *behavior );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    behavior

    Указатель на память. По возврату эта память содержит поведение появления заголовка для этой предпочтительной установки. Поскольку возможные значения видят Поведение Появления Заголовка. Передача NULL когда Вам не нужна установка поведения.

    Возвращаемое значение

    Предпочтительный цвет выведен на экран позади всех других элементов заголовка.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • MACaptionAppearanceGetWindowOpacity (_: _:) MACaptionAppearanceGetWindowOpacity

    Возвращает предпочтение непрозрачности наложения.

    Объявление

    Swift

    func MACaptionAppearanceGetWindowOpacity(_ domain: MACaptionAppearanceDomain, _ behavior: UnsafeMutablePointer<MACaptionAppearanceBehavior>) -> CGFloat

    Objective C

    CGFloat MACaptionAppearanceGetWindowOpacity ( MACaptionAppearanceDomain domain, MACaptionAppearanceBehavior *behavior );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    behavior

    Указатель на память. По возврату эта память содержит поведение появления заголовка для этой предпочтительной установки. Поскольку возможные значения видят Поведение Появления Заголовка. Передача NULL когда Вам не нужна установка поведения.

    Возвращаемое значение

    Значение плавающее, в пределах от 0.0 к 1.0, представление непрозрачности цвета позади всех других элементов заголовка.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • MACaptionAppearanceGetWindowRoundedCornerRadius (_: _:) MACaptionAppearanceGetWindowRoundedCornerRadius

    Возвращает радиус углов окна заголовка.

    Объявление

    Swift

    func MACaptionAppearanceGetWindowRoundedCornerRadius(_ domain: MACaptionAppearanceDomain, _ behavior: UnsafeMutablePointer<MACaptionAppearanceBehavior>) -> CGFloat

    Objective C

    CGFloat MACaptionAppearanceGetWindowRoundedCornerRadius ( MACaptionAppearanceDomain domain, MACaptionAppearanceBehavior *behavior );

    Параметры

    domain

    Домен для получения предпочтительного значения от. Посмотрите Домены Появления Заголовка. Передача kMACaptionAppearanceDomainUser если системные значения по умолчанию не необходимы для сравнения.

    behavior

    Указатель на память. По возврату эта память содержит поведение появления заголовка для этой предпочтительной установки. Поскольку возможные значения видят Поведение Появления Заголовка. Передача NULL когда Вам не нужна установка поведения.

    Возвращаемое значение

    Параметр настройки системы для углового радиуса окна заголовка.

    Обсуждение

    Скругленные углы окна заголовка не настраиваемы в предпочтениях Доступности и не изменяются на основе размера текста.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

Константы

  • Домены появления заголовка

    Значение раньше указывало, от какого домена предпочтительная установка получена.

    Объявление

    Swift

    enum MACaptionAppearanceDomain : CFIndex { case Default case User }

    Objective C

    typedef enum : CFIndex { kMACaptionAppearanceDomainDefault = 0, kMACaptionAppearanceDomainUser = 1, } MACaptionAppearanceDomain;

    Константы

    • Default

      kMACaptionAppearanceDomainDefault

      Системное значение по умолчанию для установки должно быть возвращено.

      Доступный в OS X v10.9 и позже.

    • User

      kMACaptionAppearanceDomainUser

      Предпочтительное значение пользователя для установки должно быть возвращено.

      Доступный в OS X v10.9 и позже.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • Тип дисплея появления заголовка

    Значение раньше указывало тип заголовков, которые будут выведены на экран.

    Объявление

    Swift

    enum MACaptionAppearanceDisplayType : CFIndex { case ForcedOnly case Automatic case AlwaysOn }

    Objective C

    typedef enum : CFIndex { kMACaptionAppearanceDisplayTypeForcedOnly = 0, kMACaptionAppearanceDisplayTypeAutomatic = 1, kMACaptionAppearanceDisplayTypeAlwaysOn = 2, } MACaptionAppearanceDisplayType;

    Константы

    • ForcedOnly

      kMACaptionAppearanceDisplayTypeForcedOnly

      Не выводите на экран заголовки, если они не вынуждены для перевода.

      Доступный в OS X v10.9 и позже.

    • Automatic

      kMACaptionAppearanceDisplayTypeAutomatic

      Если язык аудиотрека отличается от системной локали, то заголовки, соответствующие системную локаль, должны быть выведены на экран (при наличии). Если язык аудио и язык системного соответствия локали, не показаны никакие заголовки.

      Доступный в OS X v10.9 и позже.

    • AlwaysOn

      kMACaptionAppearanceDisplayTypeAlwaysOn

      Самая устойчивая доступная дорожка ввода субтитров должна всегда выводиться на экран, ли подзаголовки, CC или SDH. Эта опция выбрана переключателем маркированные “Субтитры + SDH” (на странице Subtitles & Captioning iOS) и флажок «Prefer Closed Captions and SDH» (на области Captions опций Accessibility на OS X).

      Доступный в OS X v10.9 и позже.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • Поведение появления заголовка

    Значение раньше указывало предпочтительное поведение для предпочтительной установки.

    Объявление

    Swift

    enum MACaptionAppearanceBehavior : CFIndex { case UseValue case UseContentIfAvailable }

    Objective C

    typedef enum : CFIndex { kMACaptionAppearanceBehaviorUseValue = 0, kMACaptionAppearanceBehaviorUseContentIfAvailable = 1, } MACaptionAppearanceBehavior;

    Константы

    • UseValue

      kMACaptionAppearanceBehaviorUseValue

      Предпочтительная установка должна всегда использоваться.

      Доступный в OS X v10.9 и позже.

    • UseContentIfAvailable

      kMACaptionAppearanceBehaviorUseContentIfAvailable

      Предпочтительная установка должна использоваться, если играемые носители содержания не имеют его собственное значение для этой установки.

      Доступный в OS X v10.9 и позже.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • Стиль шрифта появления заголовка

    Значение раньше указывало стиль шрифта.

    Объявление

    Swift

    enum MACaptionAppearanceFontStyle : CFIndex { case Default case MonospacedWithSerif case ProportionalWithSerif case MonospacedWithoutSerif case ProportionalWithoutSerif case Casual case Cursive case SmallCapital }

    Objective C

    typedef enum : CFIndex { kMACaptionAppearanceFontStyleDefault = 0, kMACaptionAppearanceFontStyleMonospacedWithSerif = 1, kMACaptionAppearanceFontStyleProportionalWithSerif = 2, kMACaptionAppearanceFontStyleMonospacedWithoutSerif = 3, kMACaptionAppearanceFontStyleProportionalWithoutSerif = 4, kMACaptionAppearanceFontStyleCasual = 5, kMACaptionAppearanceFontStyleCursive = 6, kMACaptionAppearanceFontStyleSmallCapital = 7, } MACaptionAppearanceFontStyle;

    Константы

    • Default

      kMACaptionAppearanceFontStyleDefault

      Стиль стандартного шрифта для всего текста подписи.

      Доступный в OS X v10.9 и позже.

    • MonospacedWithSerif

      kMACaptionAppearanceFontStyleMonospacedWithSerif

      Стиль шрифта предпочтен для моноширинного стиля шрифта засечки.

      Доступный в OS X v10.9 и позже.

    • ProportionalWithSerif

      kMACaptionAppearanceFontStyleProportionalWithSerif

      Стиль шрифта предпочтен для пропорционального стиля шрифта засечки.

      Доступный в OS X v10.9 и позже.

    • MonospacedWithoutSerif

      kMACaptionAppearanceFontStyleMonospacedWithoutSerif

      Стиль шрифта предпочтен для моноширинного стиля шрифта гротескового шрифта.

      Доступный в OS X v10.9 и позже.

    • ProportionalWithoutSerif

      kMACaptionAppearanceFontStyleProportionalWithoutSerif

      Стиль шрифта предпочтен для пропорционального стиля шрифта гротескового шрифта.

      Доступный в OS X v10.9 и позже.

    • Casual

      kMACaptionAppearanceFontStyleCasual

      Стиль шрифта предпочтен для случайного стиля шрифта.

      Доступный в OS X v10.9 и позже.

    • Cursive

      kMACaptionAppearanceFontStyleCursive

      Стиль шрифта предпочтен для рукописного стиля шрифта.

      Доступный в OS X v10.9 и позже.

    • SmallCapital

      kMACaptionAppearanceFontStyleSmallCapital

      Стиль шрифта предпочтен для маленького прописного стиля шрифта.

      Доступный в OS X v10.9 и позже.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • Текстовый граничный стиль появления заголовка

    Значение раньше указывало подробность, добавленную к за пределами текста.

    Объявление

    Swift

    enum MACaptionAppearanceTextEdgeStyle : CFIndex { case Undefined case None case Raised case Depressed case Uniform case DropShadow }

    Objective C

    typedef enum : CFIndex {] kMACaptionAppearanceTextEdgeStyleUndefined = 0, ] kMACaptionAppearanceTextEdgeStyleNone = 1, kMACaptionAppearanceTextEdgeStyleRaised = 2, kMACaptionAppearanceTextEdgeStyleDepressed = 3, kMACaptionAppearanceTextEdgeStyleUniform = 4, kMACaptionAppearanceTextEdgeStyleDropShadow = 5, } MACaptionAppearanceTextEdgeStyle;

    Константы

    • Undefined

      kMACaptionAppearanceTextEdgeStyleUndefined

      Граничный стиль не был указан.

      Доступный в OS X v10.9 и позже.

    • None

      kMACaptionAppearanceTextEdgeStyleNone

      Текст не должен иметь стилизованного края.

      Доступный в OS X v10.9 и позже.

    • Raised

      kMACaptionAppearanceTextEdgeStyleRaised

      Край заставляет текст, казаться, повыситься выше фона.

      Доступный в OS X v10.9 и позже.

    • Depressed

      kMACaptionAppearanceTextEdgeStyleDepressed

      Край заставляет текст казаться продвинутым в.

      Доступный в OS X v10.9 и позже.

    • Uniform

      kMACaptionAppearanceTextEdgeStyleUniform

      Тонкая схема простирается вдоль края текста.

      Доступный в OS X v10.9 и позже.

    • DropShadow

      kMACaptionAppearanceTextEdgeStyleDropShadow

      Край заставляет текст, казаться, плавать выше фона.

      Доступный в OS X v10.9 и позже.

    Оператор импорта

    Objective C

    @import MediaAccessibility;

    Swift

    import MediaAccessibility

    Доступность

    Доступный в OS X v10.9 и позже.

  • Характеристики аудиотрека

    Значение раньше указывало предпочтения аудиотреков.

    Объявление

    Swift

    let MAMediaCharacteristicDescribesMusicAndSoundForAccessibility: CFString! let MAMediaCharacteristicTranscribesSpokenDialogForAccessibility: CFString!

    Objective C

    CFStringRef const MAMediaCharacteristicDescribesMusicAndSoundForAccessibility; CFStringRef const MAMediaCharacteristicTranscribesSpokenDialogForAccessibility;

    Константы

    • MAMediaCharacteristicDescribesMusicAndSoundForAccessibility

      MAMediaCharacteristicDescribesMusicAndSoundForAccessibility

      Пользователь хочет заголовки, описывающие музыку, и звук (кроме разговорного диалогового окна), такого как звуковые эффекты и значительный заставляет замолчать.

      Доступный в OS X v10.9 и позже.

    • MAMediaCharacteristicTranscribesSpokenDialogForAccessibility

      MAMediaCharacteristicTranscribesSpokenDialogForAccessibility

      Пользователь хочет заголовки для разговорного диалогового окна. Заголовки должны также идентифицировать динамики каждый раз, когда другие визуальные индикаторы недостаточны для средства просмотра для определения, кто говорит.

      Доступный в OS X v10.9 и позже.