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

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

Разработчик

Ссылка класса ITLibMediaItem

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

На этой странице

ITLibMediaItem

ITLibMediaItem класс описывает элемент носителей (дорожка) в библиотеке iTunes, такой как песня, видео или подкаст. Как все объекты носителей, каждый элемент носителей имеет уникальный идентификатор и ряд свойств.

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

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

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

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

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

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

Получение информации об этом элементе носителей
  • заголовок заголовок Свойство

    Заголовок этого элемента носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * title;

  • sortTitle sortTitle Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * sortTitle;

    Обсуждение

    Если, например, заголовком элемента носителей являются Звуки музыки, и заголовок вида является Звуком Музыки, когда элементы носителей видов iTunes заголовком, этот элемент носителей был бы сгруппирован с другими элементами носителей, заголовки которых начинаются с «S».

    Если никакой заголовок вида не указан, это свойство является нолем, и iTunes использует значение title свойство, когда это сортирует элементы носителей.

  • художник художник Свойство

    Информация о художнике связалась с этим элементом носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) ITLibArtist * artist;

  • композитор композитор Свойство

    Имя композитора связалось с этим элементом носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * composer;

  • sortComposer sortComposer Свойство

    Имя, которое iTunes использует при сортировке композитором. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * sortComposer;

    Обсуждение

    Если, например, композитором элементов носителей является «Людвиг ван Бетховен», и композитор вида является «фургоном Бетховена Людвига», когда элементы носителей видов iTunes композитором, этот элемент носителей был бы сгруппирован с другими элементами носителей, композиторы которых начинают с «B».

    Если никакой композитор вида не указан, это свойство nil и iTunes использует значение свойства композитора, когда это сортирует элементы носителей композитором.

  • оценка оценка Свойство

    Оценка этого элемента носителей. Посмотрите ratingComputed для получения дополнительной информации. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSInteger rating;

  • ratingComputed ratingComputed Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, assign, getter = isRatingComputer) BOOL ratingComputed;

    Обсуждение

    Если пользователь оценил альбом, все дорожки в том альбоме, не имеющие никакой оценки, получат альбом, оценивающий по умолчанию. Пользователь может переопределить оценки путем предоставления фактических оценок для каждой дорожки.

  • startTime startTime Свойство

    Если этот элемент носителей является подкастом, это свойство содержит время начала подкаста. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger startTime;

    Обсуждение

    Если этот элемент носителей не является подкастом, это свойство 0.

  • stopTime stopTime Свойство

    Если этот элемент носителей является подкастом, это свойство содержит время остановки подкаста. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger stopTime;

    Обсуждение

    Если этот элемент носителей не является подкастом, это свойство 0.

  • альбом альбом Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) ITLibAlbum * album;

    Обсуждение

    Если этот элемент носителей не является аудиотреком, это свойство является нолем.

  • жанр жанр Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * genre;

  • вид вид Свойство

    Специфичное для iTunes строковое представление вида этого элемента носителей; например, "MPEG audio file" или "Book". (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * kind;

  • mediaKind mediaKind Свойство

    Этот вид носителей элемента носителей. Посмотрите ITLibMediaItemMediaKind перечисление для списка возможных значений вида носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) ITLibMediaItemMediaKind mediaKind;

  • размер размер Свойство

    Размер в байтах этого элемента носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger size;

  • totalTime totalTime Свойство

    Длина этого элемента носителей в секундах. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger totalTime;

  • trackNumber trackNumber Свойство

    Номер дорожки этого элемента носителей в его альбоме. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger trackNumber;

  • категория категория Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * category;

    Обсуждение

    Если элемент носителей не является подкастом, это свойство является нолем.

    Лицо, создающее подкаст, указывает категорию.

  • описание описание Свойство

    Если этот элемент носителей является подкастом, это свойство содержит описание подкаста. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * description;

    Обсуждение

    Если элемент носителей не является подкастом, это свойство является нолем.

  • contentRating contentRating Свойство

    Оценка содержания этого элемента носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * contentRating;

  • lyricsContentRating lyricsContentRating Свойство

    Если этот элемент носителей связал лирику, это свойство указывает довольное оценка для той лирики. Посмотрите ITLibMediaItemLyricsContentRating перечисление для списка возможных лирических оценок содержания. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) ITLibMediaItemLyricsContentRating lyricsContentRating;

    Обсуждение

    Если этот элемент носителей не имеет связанной лирики, это свойство ITLibMediaItemLyricsContentRatingNone.

  • addedDate addedDate Свойство

    Дата, когда этот элемент носителей был добавлен к iTunes. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) NSDate * addedDate;

  • modifiedDate modifiedDate Свойство

    Дата и время этот элемент носителей была в последний раз изменена в iTunes. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) NSDate * modifiedDate;

  • скорость передачи скорость передачи Свойство

    Скорость передачи этого элемента носителей в Кбит/с. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger bitrate;

  • sampleRate sampleRate Свойство

    Частота дискретизации этого элемента носителей в выборках в секунду. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger sampleRate;

  • beatsPerMinute beatsPerMinute Свойство

    Если этот элемент носителей является аудиотреком, это свойство содержит Удары в минуту (BPM) аудио. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger beatsPerMinute;

  • playCount playCount Свойство

    Число раз этот элемент носителей игралось в iTunes. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger playCount;

  • lastPlayedDate lastPlayedDate Свойство

    Дата и время этот элемент носителей в последний раз игрался в iTunes или ноле, если не игрался этот элемент носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) NSDate * lastPlayedDate;

  • расположение расположение Свойство

    Расположение этого элемента носителей при наличии. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) NSURL * location;

    Обсуждение

    Если расположение этого элемента носителей не доступно, это свойство возвраты ITLibMediaItemLocationTypeUnknown.

    Этот метод возвращает URLs, который является за пределами песочницы по умолчанию. Для использования iTunesLibrary платформы поигравшее в песочнице приложение должно иметь com.apple.security.assets.music.read-write или com.apple.security.assets.music.read-only право.

    Для доступа к файлу элемента носителей в поигравшем в песочнице приложении вызовите startAccessingSecurityScopedResource функция.

    Перечисление 1Accessing медиа-файл из поигравшего в песочнице приложения
    • #import <iTunesLibrary/ITLibrary.h>
    • #import <iTunesLibrary/ITLibMediaItem.h>
    • // Initialize
    • NSError * error = nil;
    • ITLibrary* library =
    • [[ITLibrary alloc] initWithAPIVersion:@"1.0" error:&error];
    • if (library)
    • {
    • // Get first media item in the library
    • NSArray * mediaItems = library.allMediaItems;
    • if (mediaItems.count > 0)
    • {
    • // Get the location (URL) of the first media item and
    • // prepare it for file read/write access.
    • ITLibMediaItem * mediaItem =
    • (ITLibMediaItem*)[mediaItems objectAtIndex:0];
    • NSURL * mediaItemLocation = mediaItem.location;
    • if (mediaItemLocation &&
    • [mediaItemLocation startAccessingSecurityScopedResource])
    • {
    • // mediaItemLocation can be now used to read/write
    • // the media file
    • [mediaItemLocation stopAccessingSecurityScopedResource];
    • }
    • }
    • }

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

    В непоигравших в песочнице приложениях можно использовать возвращенное расположение URL для доступа к файлу элемента носителей непосредственно.

  • locationType locationType Свойство

    Вид расположения этого элемента носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) ITLibMediaItemLocationType locationType;

    Обсуждение

    Посмотрите ITLibMediaItemLocationType перечисление для списка возможных типов расположения.

  • artworkAvailable artworkAvailable Свойство

    Имеет ли этот элемент носителей иллюстрации. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign, getter=hasArtworkAvailable) BOOL artworkAvailable;

  • иллюстрации иллюстрации Свойство

    Иллюстрации этого элемента носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) ITLibArtwork * artwork;

  • комментарии комментарии Свойство

    Любые комментарии связались с этим элементом носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * comments;

  • купленный купленный Свойство

    Был ли этот элемент носителей куплен от хранилища iTunes. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign, getter=isPurchased) BOOL purchased;

  • drmProtected drmProtected Свойство

    Является ли этот элемент носителей защищенным DRM. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign, getter=isDRMProtected) BOOL drmProtected;

  • видео видео Свойство

    Является ли этот элемент носителей видео, таким как сериал, видеоподкаст или фильм. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign, getter=isVideo) BOOL video;

  • videoInfo videoInfo Свойство

    Видеоинформация (такая как ширина и высота) об этом элементе носителей, если это - видео элемент носителей. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) ITLibMediaItemVideoInfo * videoInfo;

    Обсуждение

    Если этот элемент носителей не является видео элементом носителей, это свойство является нолем.

  • releaseDate releaseDate Свойство

    Дата этот элемент носителей была выпущена. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) NSDate * releaseDate;

  • год год Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger year;

  • тип файла тип файла Свойство

    Тип файла Mac OS этого элемента носителей (осужден). (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger fileType;

    Обсуждение

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

  • skipCount skipCount Свойство

    Число раз пользователь пропустило этот элемент носителей в iTunes. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger skipCount;

  • skipDate skipDate Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, retain) NSDate * skipDate;

  • voiceOverLanguage voiceOverLanguage Свойство

    Язык голоса за кадром этого элемента носителей если применимо. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * voiceOverLanguage;

    Обсуждение

    Если язык голоса за кадром этого элемента носителей не применим, это свойство является нолем.

  • volumeAdjustment volumeAdjustment Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSInteger volumeAdjustment;

  • volumeNormalizationEnergy volumeNormalizationEnergy Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, assign) NSUInteger volumeNormalizationEnergy;

  • userDisabled userDisabled Свойство

    Отключил ли пользователь этот элемент носителей в iTunes. (только для чтения)

    Объявление

    Objective C

    @property (readonly, nonatomic, assign, getter = isUserDisabled) BOOL userDisabled;

    Обсуждение

    Отключенные треки не будут играться или синхронизироваться iTunes.

  • группировка группировка Свойство

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

    Объявление

    Objective C

    @property (readonly, nonatomic, copy) NSString * grouping;

Константы
  • ITLibMediaItemLocationType

    Эти константы указывают возможные типы расположения элементов носителей. Посмотрите locationType свойство.

    Объявление

    Objective C

    enum { ITLibMediaItemLocationTypeUnknown = 0, ITLibMediaItemLocationTypeFile = 1, ITLibMediaItemLocationTypeURL = 2, ITLibMediaItemLocationTypeRemote = 3 };

    Константы

    • ITLibMediaItemLocationTypeUnknown

      ITLibMediaItemLocationTypeUnknown

      Расположение элемента носителей не известно.

    • ITLibMediaItemLocationTypeFile

      ITLibMediaItemLocationTypeFile

      Элемент носителей находится в локальном файле.

    • ITLibMediaItemLocationTypeURL

      ITLibMediaItemLocationTypeURL

      Элемент носителей является удаленным файлом с известным URL.

    • ITLibMediaItemLocationTypeRemote

      ITLibMediaItemLocationTypeRemote

      Элемент носителей находится в удаленном файле, таком как сетевой диск.

  • ITLibMediaItemLyricsContentRating

    Эти константы указывают возможные оценки лирики элемента носителей. Посмотрите lyricsContentRating.

    Объявление

    Objective C

    enum { ITLibMediaItemLyricsContentRatingNone = 0, ITLibMediaItemLyricsContentRatingExplicit = 1, ITLibMediaItemLyricsContentRatingClean = 2 };

    Константы

    • ITLibMediaItemLyricsContentRatingNone

      ITLibMediaItemLyricsContentRatingNone

      Никакая информация об оценке для лирики элемента носителей не доступна.

    • ITLibMediaItemLyricsContentRatingExplicit

      ITLibMediaItemLyricsContentRatingExplicit

      Лирика элемента носителей содержит явный язык.

    • ITLibMediaItemLyricsContentRatingClean

      ITLibMediaItemLyricsContentRatingClean

      Лирика элемента носителей не содержит явный язык.

  • ITLibMediaItemMediaKind

    Эти константы указывают возможные виды носителей элемента носителей. Посмотрите mediaKind свойство.

    Объявление

    Objective C

    enum { ITLibMediaItemMediaKindUnknown = 1, ITLibMediaItemMediaKindSong = 2, ITLibMediaItemMediaKindMovie = 3, ITLibMediaItemMediaKindPodcast = 4, ITLibMediaItemMediaKindAudiobook = 5, ITLibMediaItemMediaKindPDFBooklet = 6, ITLibMediaItemMediaKindMusicVideo = 7, ITLibMediaItemMediaKindTVShow = 8, ITLibMediaItemMediaKindInteractiveBooklet = 9, ITLibMediaItemMediaKindVideoPass = 11, ITLibMediaItemMediaKindHomeVideo = 12, ITLibMediaItemMediaKindRingtone = 14, ITLibMediaItemMediaKindDigitalBooklet = 15, ITLibMediaItemMediaKindIOSApplication = 16, ITLibMediaItemMediaKindVoiceMemo = 17, ITLibMediaItemMediaKindiTunesU = 18, ITLibMediaItemMediaKindBook = 19, ITLibMediaItemMediaKindPDFBook = 20, ITLibMediaItemMediaKindAlertTone = 21 };

    Константы

    • ITLibMediaItemMediaKindUnknown

      ITLibMediaItemMediaKindUnknown

      Тип элемента носителей не известен.

    • ITLibMediaItemMediaKindSong

      ITLibMediaItemMediaKindSong

      Элемент носителей является песней.

    • ITLibMediaItemMediaKindMovie

      ITLibMediaItemMediaKindMovie

      Элемент носителей является фильмом.

    • ITLibMediaItemMediaKindPodcast

      ITLibMediaItemMediaKindPodcast

      Элемент носителей является аудиоподкастом или видеоподкастом.

    • ITLibMediaItemMediaKindAudiobook

      ITLibMediaItemMediaKindAudiobook

      Элемент носителей является аудиокнигой.

    • ITLibMediaItemMediaKindPDFBooklet

      ITLibMediaItemMediaKindPDFBooklet

      Элемент носителей является развернутым файлом PDF, который является частью музыкального альбома.

    • ITLibMediaItemMediaKindMusicVideo

      ITLibMediaItemMediaKindMusicVideo

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

    • ITLibMediaItemMediaKindTVShow

      ITLibMediaItemMediaKindTVShow

      Элемент носителей является сериалом.

    • ITLibMediaItemMediaKindInteractiveBooklet

      ITLibMediaItemMediaKindInteractiveBooklet

      Элемент носителей является фильмом в формате QuickTime со встроенным (осуждаемым) Flash.

    • ITLibMediaItemMediaKindVideoPass

      ITLibMediaItemMediaKindVideoPass

      Элементом носителей является Передача iTunes с видео.

    • ITLibMediaItemMediaKindHomeVideo

      ITLibMediaItemMediaKindHomeVideo

      Элемент носителей является фильмом хранилища не-iTunes.

    • ITLibMediaItemMediaKindRingtone

      ITLibMediaItemMediaKindRingtone

      Элемент носителей является вызывным тональным сигналом.

    • ITLibMediaItemMediaKindDigitalBooklet

      ITLibMediaItemMediaKindDigitalBooklet

      Элементом носителей является Дополнительный iTunes или iTunes LP.

    • ITLibMediaItemMediaKindIOSApplication

      ITLibMediaItemMediaKindIOSApplication

      Элемент носителей является приложением для iOS.

    • ITLibMediaItemMediaKindVoiceMemo

      ITLibMediaItemMediaKindVoiceMemo

      Элемент носителей является речевым уведомлением, зарегистрированным на iPod/iPhone или iPad.

    • ITLibMediaItemMediaKindiTunesU

      ITLibMediaItemMediaKindiTunesU

      Элемент носителей является каналом iTunesU.

    • ITLibMediaItemMediaKindBook

      ITLibMediaItemMediaKindBook

      Элемент носителей является электронной книгой, такой как EPUB.

    • ITLibMediaItemMediaKindPDFBook

      ITLibMediaItemMediaKindPDFBook

      Элемент носителей является универсальным файлом PDF.

    • ITLibMediaItemMediaKindAlertTone

      ITLibMediaItemMediaKindAlertTone

      Элемент носителей является аудио тоном на устройстве на iOS.