ITLibrary

ITLibrary класс служит точкой входа к iTunesLibrary платформе. Свойства и методы ITLibrary может использоваться для получения элементов носителей (дорожки) и списки воспроизведения от библиотеки iTunes пользователя. ITLibrary также обеспечивает методы для извлечения иллюстраций от медиа-файла, который может или может не быть в библиотеке iTunes. Эта функциональность предоставлена для поигравших в песочнице и непоигравших в песочнице приложений, желающих снова использовать возможность iTunes извлечь иллюстрации.

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

Не применимый

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

Не применимый

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

Не применимый не применимый

Получение информации О Библиотеке iTunes


    
    artworkForMediaFile:
    - artworkForMediaFile:

Получает иллюстрации от медиа-файла, который может или может не быть в библиотеке iTunes.

Объявление

Objective C

- (ITLibArtwork*) artworkForMediaFile:(NSURL*)mediaFileURL;

Параметры


      mediaFileURL

URL медиа-файла, иллюстрации которого должны быть получены. Медиа-файл может или может не быть в библиотеке iTunes.

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

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


    
    initWithAPIVersion:error:
    - initWithAPIVersion:error:

Инициализирует экземпляр ITLibrary.

Объявление

Objective C

- (id) initWithAPIVersion:(NSString*)requestedAPIVersion error:(NSError **)error;

Параметры

`requestedAPIVersion`	Версия iTunesLibrary платформы API, который запрашивает приложение. Установите этот параметр на `"1.0"` если неизвестный. Единственная поддерживаемая версия в данный момент «1.0».
`error`	Указатель на переменную, которая получит `NSError` если этот метод перестал работать. Установите этот параметр на `nil` если вызывающая сторона не заботится об ошибке.

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

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

Обсуждение

На инициализацию ITLibrary класс, база данных iTunes по умолчанию для текущего пользователя читается и анализируется. В этой точке все объекты носителей (дорожки) и списки воспроизведения кэшируются в памяти, пока не освобожден объект.

Перечисление 1Initializing ITLibrary

      #import <iTunesLibrary/ITLibrary.h>
 
NSError * error = nil;
ITLibrary* library = [[ITLibrary alloc] initWithAPIVersion:@"1.0" error:&error];
if (library)
{
  NSArray playlists = library.allPlaylists; //  <- NSArray of ITLibPlaylist
  NSArray mediaItems = library.allMediaItems; //  <- NSArray of ITLibMediaItem
}

См. также libraryWithAPIVersion:error:.


    
    libraryWithAPIVersion:error:
    + libraryWithAPIVersion:error:

Создает и инициализирует экземпляр ITLibrary.

Объявление

Objective C

+ (id) libraryWithAPIVersion:(NSString*)requestedAPIVersion error:(NSError **)error;

Параметры

`requestedAPIVersion`	Версия iTunesLibrary платформы API, который запрашивает приложение. Установите этот параметр на `"1.0"` если неизвестный. Единственная поддерживаемая версия в данный момент «1.0».
`error`	Указатель на переменную, которая получит `NSError` если этот метод перестал работать. Установите этот параметр на `nil` если вызывающая сторона не заботится об ошибке.

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

ITLibrary экземпляр или nil если этот метод перестал работать.

Обсуждение

На инициализацию ITLibrary класс, база данных iTunes по умолчанию для текущего пользователя читается и анализируется. В той точке все объекты носителей (дорожки) и списки воспроизведения кэшируются в памяти, пока не освобожден объект.

Перечисление 2Creating и инициализация ITLibrary

      #import <iTunesLibrary/ITLibrary.h>
 
NSError * error = nil;
ITLibrary* library = [libraryWithAPIVersion:@"1.0" error:&error];
if (library)
{
  NSArray playlists = library.allPlaylists; //  <- NSArray of ITLibPlaylist
  NSArray mediaItems = library.allMediaItems; //  <- NSArray of ITLibMediaItem
}

См. также initWithAPIVersion:error:.

showContentRating showContentRating Свойство

Показать ли довольный метки оценки. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, assign, getter = shouldShowContentRating) BOOL showContentRating;
musicFolderLocation musicFolderLocation Свойство

Расположение музыкальной папки iTunes. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, copy) NSURL * musicFolderLocation;
функции функции Свойство

Осуждаемый. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, assign) ITLibExportFeature features;

Обсуждение

Это свойство было осуждено и будет удалено в будущих версиях платформы.
applicationVersion applicationVersion Свойство

Версия iTunes, создавшего или изменившего получаемую доступ библиотеку iTunes. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, copy) NSString * applicationVersion;
apiMinorVersion apiMinorVersion Свойство

Номер вспомогательной версии API представлен iTunesLibrary платформой. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, assign) NSUInteger apiMinorVersion;
apiMajorVersion apiMajorVersion Свойство

Номер основной версии API представлен iTunesLibrary платформой. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, assign) NSUInteger apiMajorVersion;
allPlaylists allPlaylists Свойство

Все списки воспроизведения в библиотеке iTunes. (только для чтения)

Объявление

Objective C

@property (nonatomic, readonly, retain) NSArray * allPlaylists;

Обсуждение

Возвращает массив ITLibPlaylists. Посмотрите Ссылку класса ITLibPlaylist.
allMediaItems allMediaItems Свойство

Все элементы носителей (дорожки) в библиотеке iTunes.

Объявление

Objective C

@property (nonatomic, readonly, retain) NSArray * allMediaItems;

Обсуждение

Возвращает массив ITLibMediaItems. Посмотрите Ссылку класса ITLibMediaItem.