MLMediaGroup
MLMediaGroup
класс обеспечивает группировки для мультимедийных объектов из единственного источника носителей, таких как iTunes или Апертура. Мультимедийные объекты — на отдельные файлы, содержащие часть носителей, такие как фотография, песня или фильм — ссылаются одна или более групп в каждом источнике носителей. Эти группировки служат фильтрами, обеспечивая иерархическую структуру для набора объектов в каждом источнике.
Структура иерархии группы является определенной для каждого источника носителей, но все источники имеют определенные общности. Например, каждый источник имеет единственную корневую медиа-группу, содержащую все группы и объекты в том источнике. Это - родительская группа высшего уровня в иерархии, и каждая из ее порожденных групп содержит свои собственные подгруппы и их объекты. У всех групп есть ссылка на их родителя в иерархии. Группа без потомков содержит только свои собственные объекты. Если медиа-группа не содержит объектов, это не видимо в иерархии.
Медиа-группа имеет массив атрибутов, которые могут измениться в любой точке. Например, медиа-группа может иметь определенные атрибуты, описывающие ее объекты, но эти атрибуты появляются только после того, как объекты для той группы были загружены. Когда любой атрибут медиа-группы изменяется, наблюдатели уведомляются через уведомление KVO. Для получения информации об обработке атрибутов, изменяющихся, посмотрите, что Привязка Какао Программирует Темы.
Каждая медиа-группа имеет уникальный идентификатор, а также идентификатор типа. В определенных случаях у многократных групп в источнике может быть тот же идентификатор типа. Для описаний идентификаторов типов группы посмотрите Ссылку Констант Библиотеки Носителей.
Все MLMediaGroup
свойства только для чтения, таким образом, к этой информации можно получить доступ, но не изменить.
Оператор импорта
Swift
import MediaLibrary
Objective C
@import MediaLibrary;
Доступность
Доступный в OS X v10.9 и позже.
-
идентификатор идентификатор
СвойствоИдентификатор для медиа-группы. (только для чтения)
Объявление
Swift
var identifier: String! { get }
Objective C
@property(readonly, copy) NSString *identifier
Обсуждение
Идентификатор каждой группы уникален в источнике носителей.
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
typeIdentifier typeIdentifier
СвойствоИдентификатор для типа медиа-группы. (только для чтения)
Объявление
Swift
var typeIdentifier: String! { get }
Objective C
@property(readonly, copy) NSString *typeIdentifier
Обсуждение
У многократных групп в источнике носителей может быть тот же идентификатор типа. Для описаний идентификаторов типов группы посмотрите Ссылку Констант Библиотеки Носителей.
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
Идентификатор для источника, загрузившего медиа-группу. (только для чтения)
Объявление
Swift
var mediaSourceIdentifier: String! { get }
Objective C
@property(readonly, copy) NSString *mediaSourceIdentifier
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
mediaLibrary mediaLibrary
СвойствоУказатель на экземпляр библиотеки носителей, загрузивший источник медиа-группы. (только для чтения)
Объявление
Swift
unowned(unsafe) var mediaLibrary: MLMediaLibrary! { get }
Objective C
@property(readonly, assign) MLMediaLibrary *mediaLibrary
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
Словарь атрибутов, описывающих медиа-группу. (только для чтения)
Объявление
Swift
var attributes: [NSObject : AnyObject]! { get }
Objective C
@property(readonly, copy) NSDictionary *attributes
Обсуждение
Эти атрибуты обычно определяются исходным приложением, таким как iTunes. Например, список воспроизведения iTunes представлен как группа. iTunes присоединяет атрибуты, такие как «Список воспроизведения Персистентный ID» группе в
attributes
. Названия атрибута варьируются на основе источника носителей. Атрибуты, характерные для всех источников, вызываются как отдельные свойства.Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
Имя медиа-группы. (только для чтения)
Обсуждение
Эта строка человекочитаема. Это - любой создаваемый пользователь (такой как имя списка воспроизведения iTunes) или уже локализованный.
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
Расположение медиа-группы. (только для чтения)
Объявление
Swift
@NSCopying var URL: NSURL! { get }
Objective C
@property(readonly, copy) NSURL *URL
Обсуждение
У некоторых групп нет URL, когда это возвращается
nil
. Например, у группы, представляющей папку файловой системы на диске, есть URL, но группа, представляющая именованную поверхность в iPhoto, не делает.Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
modificationDate modificationDate
СвойствоДата и время, когда была в последний раз изменена медиа-группа. (только для чтения)
Объявление
Swift
@NSCopying var modificationDate: NSDate! { get }
Objective C
@property(readonly, copy) NSDate *modificationDate
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
Родительская группа медиа-группы. (только для чтения)
Объявление
Swift
unowned(unsafe) var parent: MLMediaGroup! { get }
Objective C
@property(readonly, assign) MLMediaGroup *parent
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
childGroups childGroups
СвойствоСписок дочерних групп содержится в медиа-группе. (только для чтения)
Объявление
Swift
var childGroups: [AnyObject]! { get }
Objective C
@property(readonly, copy) NSArray *childGroups
Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.
-
mediaObjects mediaObjects
СвойствоСписок мультимедийных объектов в медиа-группе. (только для чтения)
Объявление
Swift
var mediaObjects: [AnyObject]! { get }
Objective C
@property(readonly, copy) NSArray *mediaObjects
Обсуждение
Это свойство средства доступа неблокирует. Если еще нет никаких данных, это возвращается
nil
и автоматически инициировал внутренний асинхронный запрос. Когда данные поступят, уведомление KVO будет отправлено через основной поток.Оператор импорта
Objective C
@import MediaLibrary;
Swift
import MediaLibrary
Доступность
Доступный в OS X v10.9 и позже.