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

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

Разработчик

Ссылка платформы MediaLibrary ссылка класса MLMediaLibrary

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

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

MLMediaLibrary

MLMediaLibrary класс обеспечивает интерфейс для доступа к набору мультимедийных объектов из различных источников. Это служит начальной точкой доступа платформы Библиотеки Носителей.

Структура библиотеки носителей определяется MLMediaSource, MLMediaGroup, и MLMediaObject классы. На высшем уровне все содержание в экземпляре библиотеки носителей категоризировано источником носителей. Концептуально, источник носителей respresents отдельное приложение, такое как iTunes или Апертура. Каждый источник содержит иерархию медиа-групп, происходящую из корневой группы. Эти группы состоят из мультимедийных объектов — отдельные файлы, содержащие часть носителей, такие как фотография, песня или фильм. Только одна копия каждого объекта существует в экземпляре библиотеки носителей, но на объект могут сослаться многократные группы из единственного источника. Структура иерархии группы является определенной для каждого источника носителей.

Структура рисунка 1Sample MLMediaLibrary экземпляр image: ../Art/MediaLibraryHierarchy_2x.png

Библиотека носителей инициализируется с помощью initWithOptions: метод. Параметр опций этому методу служит фильтром. Путем указания, какие папки или источники, чтобы включать или исключить во время загрузки, можно просмотреть определенное подмножество групп и объектов от набора. Все предоставленные объекты ориентированы на многопотоковое исполнение. Для описаний возможных опций загрузки посмотрите Ключи Опций Загрузки.

Случай типичного и наиболее эффективного использования должен создать и использовать один экземпляр MLMediaLibrary для времени жизни приложения. Когда базовые медиа-файлы и метаданные по системному изменению пользователя, соответствующие объекты модели данных (медиа-группы и мультимедийные объекты) автоматически обновляются, и уведомления KVO отправляются для уведомления кода вызова любых изменений. Многократные экземпляры MLMediaLibrary может создаваться и использоваться, но их источники, группы и объекты будут независимы от предоставленных другими экземплярами MLMediaLibrary.

Наследование

Соответствует

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

Swift

import MediaLibrary

Objective C

@import MediaLibrary;

Доступность

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

Инициализация библиотеки
  • init (опции:) - initWithOptions: Определяемый инициализатор

    Инициализирует библиотеку носителей на основе указанных опций загрузки.

    Объявление

    Swift

    init!(options options: [NSObject : AnyObject]!)

    Objective C

    - (instancetype)initWithOptions:(NSDictionary *)options

    Параметры

    options

    Словарь опций загрузки.

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

    Новая библиотека носителей.

    Обсуждение

    Для описаний возможных опций загрузки посмотрите Ключи Опций Загрузки.

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

    Objective C

    @import MediaLibrary;

    Swift

    import MediaLibrary

    Доступность

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

Доступ к источникам носителей
  • mediaSources mediaSources Свойство

    Возвращает словарь источников носителей идентификатором. (только для чтения)

    Объявление

    Swift

    var mediaSources: [NSObject : AnyObject]! { get }

    Objective C

    @property(readonly, copy) NSDictionary *mediaSources

    Обсуждение

    Возвраты nil в первый раз, начиная асинхронную загрузку источников носителей. Когда все источники носителей были загружены, уведомление KVO отправляется. Если нет никаких объектов в источнике носителей, источник не появляется в этом словаре.

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

    Objective C

    @import MediaLibrary;

    Swift

    import MediaLibrary

    Доступность

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

Константы
  • Ключи опций загрузки

    Ключи раньше указывали options параметр словаря initWithOptions:.

    Объявление

    Swift

    let MLMediaLoadSourceTypesKey: NSString! let MLMediaLoadIncludeSourcesKey: NSString! let MLMediaLoadExcludeSourcesKey: NSString! let MLMediaLoadFoldersKey: NSString! let MLMediaLoadAppFoldersKey: NSString!

    Objective C

    NSString* const MLMediaLoadSourceTypesKey; NSString* const MLMediaLoadIncludeSourcesKey; NSString* const MLMediaLoadExcludeSourcesKey; NSString* const MLMediaLoadFoldersKey; NSString* const MLMediaLoadAppFoldersKey;

    Константы

    • MLMediaLoadSourceTypesKey

      MLMediaLoadSourceTypesKey

      Определяет, который вводят источники загрузиться на основе библиотеки. Если не существующий, это загрузит все источники. Значение для этого ключа является исходным типом носителей. Для списка допустимых исходных типов носителей посмотрите MLMediaSourceType.

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

    • MLMediaLoadIncludeSourcesKey

      MLMediaLoadIncludeSourcesKey

      Определяет который источники носителей включать при загрузке. Если не существующий, загрузите все доступные источники носителей. Эта опция обрабатывается после MLMediaLoadSourceTypesKey. Если MLMediaLoadIncludeSourcesKey присутствует, но MLMediaLoadSourceTypesKey не, тогда только те источники, указанные здесь, будут загружены. Это полезно для загрузки единственного источника носителей. Когда оба ключа присутствуют, это полезно для добавления того или большего количества источников носителей, которые обычно не появлялись бы для требуемого типа библиотеки. Значение для этого ключа является массивом строк (исходные идентификаторы носителей). Для списка допустимых исходных идентификаторов носителей посмотрите Исходные Идентификаторы Носителей.

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

    • MLMediaLoadExcludeSourcesKey

      MLMediaLoadExcludeSourcesKey

      Определяет который источники носителей исключить при загрузке. Эта опция обрабатывается после MLMediaLoadIncludeSourcesKey. Значение для этого ключа является массивом строк (исходные идентификаторы носителей). Для списка допустимых исходных идентификаторов носителей посмотрите Исходные Идентификаторы Носителей.

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

    • MLMediaLoadFoldersKey

      MLMediaLoadFoldersKey

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

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

    • MLMediaLoadAppFoldersKey

      MLMediaLoadAppFoldersKey

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

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

  • Исходные идентификаторы носителей

    Идентификаторы для источников носителей, соответствующих приложениям, раньше управляли группами мультимедийных объектов. Используемый с Ключами Опций Загрузки.

    Объявление

    Swift

    let MLMediaSourceiPhotoIdentifier: NSString! let MLMediaSourceiTunesIdentifier: NSString! let MLMediaSourceApertureIdentifier: NSString! let MLMediaSourceiMovieIdentifier: NSString! let MLMediaSourceFinalCutIdentifier: NSString! let MLMediaSourceGarageBandIdentifier: NSString! let MLMediaSourceLogicIdentifier: NSString! let MLMediaSourcePhotoBoothIdentifier: NSString!

    Objective C

    NSString* const MLMediaSourceiPhotoIdentifier; NSString* const MLMediaSourceiTunesIdentifier; NSString* const MLMediaSourceApertureIdentifier; NSString* const MLMediaSourceiMovieIdentifier; NSString* const MLMediaSourceFinalCutIdentifier; NSString* const MLMediaSourceGarageBandIdentifier; NSString* const MLMediaSourceLogicIdentifier; NSString* const MLMediaSourcePhotoBoothIdentifier;

    Константы

    • MLMediaSourceiPhotoIdentifier

      MLMediaSourceiPhotoIdentifier

      Исходное содержание обеспечения носителей от iPhoto.

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

    • MLMediaSourceiTunesIdentifier

      MLMediaSourceiTunesIdentifier

      Исходное содержание обеспечения носителей от iTunes.

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

    • MLMediaSourceApertureIdentifier

      MLMediaSourceApertureIdentifier

      Исходное содержание обеспечения носителей от Апертуры.

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

    • MLMediaSourceiMovieIdentifier

      MLMediaSourceiMovieIdentifier

      Исходное содержание обеспечения носителей от iMovie.

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

    • MLMediaSourceFinalCutIdentifier

      MLMediaSourceFinalCutIdentifier

      Исходное содержание обеспечения носителей из Final Cut Pro.

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

    • MLMediaSourceGarageBandIdentifier

      MLMediaSourceGarageBandIdentifier

      Исходное содержание обеспечения носителей от GarageBand.

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

    • MLMediaSourceLogicIdentifier

      MLMediaSourceLogicIdentifier

      Исходное содержание обеспечения носителей от Логики.

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

    • MLMediaSourcePhotoBoothIdentifier

      MLMediaSourcePhotoBoothIdentifier

      Исходное содержание обеспечения носителей от Фотоавтомата.

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

  • Не приложение определенные исходные идентификаторы носителей

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

    Объявление

    Swift

    let MLMediaSourceMoviesFolderIdentifier: NSString! let MLMediaSourceCustomFoldersIdentifier: NSString! let MLMediaSourceAppDefinedFoldersIdentifier: NSString!

    Objective C

    NSString* const MLMediaSourceMoviesFolderIdentifier; NSString* const MLMediaSourceCustomFoldersIdentifier; NSString* const MLMediaSourceAppDefinedFoldersIdentifier;

    Константы

    • MLMediaSourceMoviesFolderIdentifier

      MLMediaSourceMoviesFolderIdentifier

      Источник носителей для папки Movies пользователя. Этот источник предоставляет данные когда MLMediaLoadFoldersKey предоставлен MLMediaLoadMoviesFolder значение.

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

    • MLMediaSourceCustomFoldersIdentifier

      MLMediaSourceCustomFoldersIdentifier

      Источник носителей для пользовательских папок. В настоящее время единственная пользовательская папка является папкой, содержащей аудио циклы от Apple. Этот источник предоставляет данные когда MLMediaLoadFoldersKey предоставлен MLMediaLoadAppleLoops значение.

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

    • MLMediaSourceAppDefinedFoldersIdentifier

      MLMediaSourceAppDefinedFoldersIdentifier

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

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

  • Известные идентификаторы папки

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

    Объявление

    Swift

    let MLMediaLoadAppleLoops: NSString! let MLMediaLoadMoviesFolder: NSString!

    Objective C

    NSString* const MLMediaLoadAppleLoops; NSString* const MLMediaLoadMoviesFolder;

    Константы

    • MLMediaLoadAppleLoops

      MLMediaLoadAppleLoops

      Идентифицирует папку, содержащую аудио циклы от Apple.

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

    • MLMediaLoadMoviesFolder

      MLMediaLoadMoviesFolder

      Идентифицирует папку Movies пользователя.

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