MPMediaItem
Соответствует
-
AnyObject -
CVarArgType -
Сопоставимый -
Hashable -
NSCoding -
NSObjectProtocol -
NSSecureCoding -
Печатаемый -
NSObject -
NSSecureCoding
Оператор импорта
Swift
import MediaPlayer
Objective C
@import MediaPlayer;
Доступность
Доступный в iOS 3.0 и позже.
Элемент носителей представляет единственную часть носителей (таких как одна песня или один видеоподкаст) в библиотеке iPod. Элемент носителей имеет полный уникальный идентификатор, получил доступ к использованию MPMediaItemPropertyPersistentID ключ свойства, а также определенные идентификаторы для его метаданных. Эти идентификаторы сохраняются через запуски приложения.
Элемент носителей может иметь широкий диапазон метаданных, связанных с ним. Вы получаете доступ к этим метаданным с помощью valueForProperty: метод вместе с ключами свойства описан в этом документе. Можно также получить доступ к метаданным пакетным способом с помощью enumerateValuesForProperties:usingBlock: метод. В некоторых случаях это более эффективно. Оба из этих методов определяются в MPMediaEntity, абстрактный суперкласс MPMediaItemCollection, и описал в Ссылке класса MPMediaEntity.
Вы используете атрибуты элементов носителей для создания мультимедийных запросов для поиска библиотеки iPod. Эти атрибуты описаны во Флагах Типа изделия Носителей, Общих Ключах Свойства Элемента Носителей и Ключах Свойства Элемента Подкаста. Кроме того, MPMediaEntityPropertyPersistentID свойство описано в Media Entity Property Keys. Мультимедийные запросы описаны в Ссылке класса MPMediaQuery.
Запускаясь в iOS 5.0, элемент носителей может представлять видео от библиотеки iPod, тогда как ранее только поддерживалось аудио. Посмотрите Флаги Типа изделия Носителей.
-
Получает персистентный ключ идентификатора для указанного типа группировки.
Объявление
Swift
class func persistentIDPropertyForGroupingType(_groupingType: MPMediaGrouping) -> String!Objective C
+ (NSString *)persistentIDPropertyForGroupingType:(MPMediaGrouping)groupingTypeПараметры
groupingTypeГруппирующийся тип, для которого Вы хотите персистентный ключ идентификатора.
Обсуждение
Используйте этот удобный метод получить ключ для определенного персистентного идентификатора на основе группирующегося типа. Можно использовать тот ключ, в свою очередь, для получения значения определенного персистентного ID элемента носителей, такого как название альбома или имя художника. Используя этот метод упрощает такие задачи как развертка от художника, к альбомам тем художником, к определенному альбому.
Например, следующее утверждение возвращает персистентный ключ идентификатора для типа группировки альбома:
NSString *albumIDKey = [MPMediaItem persistentIDPropertyForGroupingType: MPMediaGroupingAlbum];
Вы могли тогда получить определенный персистентный ID, который Вы хотите при помощи
valueForProperty:метод. Группирующиеся ключи описаны вMedia Item Collection Grouping Keys.Оператор импорта
Objective C
@import MediaPlayer;Swift
import MediaPlayerДоступность
Доступный в iOS 4.2 и позже.
-
Получает ключ заголовка для указанного типа группировки.
Объявление
Swift
class func titlePropertyForGroupingType(_groupingType: MPMediaGrouping) -> String!Objective C
+ (NSString *)titlePropertyForGroupingType:(MPMediaGrouping)groupingTypeПараметры
groupingTypeГруппирующийся тип, для которого Вы хотите ключ заголовка.
Обсуждение
Используйте этот удобный метод получить ключ для заголовка, соответствующего указанному типу группировки. Например, следующее утверждение получает ключ заголовка для типа группировки альбома:
NSString *titleIDKey = [MPMediaItem titlePropertyForGroupingType: MPMediaGroupingAlbum];
Вы могли тогда получить определенный заголовок, который Вы хотите при помощи
valueForProperty:метод. Группирующиеся ключи описаны вMedia Item Collection Grouping Keys.Оператор импорта
Objective C
@import MediaPlayer;Swift
import MediaPlayerДоступность
Доступный в iOS 4.2 и позже.
-
Типы изделия носителей, используемые в качестве возможных значений для
MPMediaItemPropertyMediaTypeсвойство. Элемент носителей может иметь больше чем один тип изделия носителей.Объявление
Swift
struct MPMediaType : RawOptionSetType { init(_rawValue: UInt) init(rawValuerawValue: UInt) static var Music: MPMediaType { get } static var Podcast: MPMediaType { get } static var AudioBook: MPMediaType { get } static var AudioITunesU: MPMediaType { get } static var AnyAudio: MPMediaType { get } static var Movie: MPMediaType { get } static var TVShow: MPMediaType { get } static var VideoPodcast: MPMediaType { get } static var MusicVideo: MPMediaType { get } static var VideoITunesU: MPMediaType { get } static var HomeVideo: MPMediaType { get } static var AnyVideo: MPMediaType { get } static var Any: MPMediaType { get } }Objective C
enum { // audio media types MPMediaTypeMusic = 1 << 0, MPMediaTypePodcast = 1 << 1, MPMediaTypeAudioBook = 1 << 2, MPMediaTypeAudioITunesU = 1 << 3, // available in iOS 5.0 MPMediaTypeAnyAudio = 0x00ff, // video media types MPMediaTypeMovie = 1 << 8, MPMediaTypeTVShow = 1 << 9, MPMediaTypeVideoPodcast = 1 << 10, MPMediaTypeMusicVideo = 1 << 11, MPMediaTypeVideoITunesU = 1 << 12, MPMediaTypeAnyVideo = 0xff00, // generic media type MPMediaTypeAny = ~0 }; typedef NSInteger MPMediaType;Константы
-
MusicMPMediaTypeMusicЕсли установлено, элемент носителей содержит музыку.
Доступный в iOS 3.0 и позже.
-
PodcastMPMediaTypePodcastЕсли установлено, элемент носителей содержит подкаст.
Доступный в iOS 3.0 и позже.
-
AudioBookMPMediaTypeAudioBookЕсли установлено, элемент носителей содержит аудиокнигу.
Доступный в iOS 3.0 и позже.
-
AnyAudioMPMediaTypeAnyAudioЕсли установлено, элемент носителей содержит неуказанный тип звукового содержимого.
Доступный в iOS 3.0 и позже.
-
MovieMPMediaTypeMovieЕсли установлено, элемент носителей содержит фильм.
Доступный в iOS 5.0 и позже.
-
TVShowMPMediaTypeTVShowЕсли установлено, элемент носителей содержит сериал.
Доступный в iOS 5.0 и позже.
-
VideoPodcastMPMediaTypeVideoPodcastЕсли установлено, элемент носителей содержит видеоподкаст.
Доступный в iOS 5.0 и позже.
-
MusicVideoMPMediaTypeMusicVideoЕсли установлено, элемент носителей содержит музыкальное видео.
Доступный в iOS 5.0 и позже.
-
VideoITunesUMPMediaTypeVideoITunesUЕсли установлено, элемент носителей содержит видео iTunes U.
Доступный в iOS 5.0 и позже.
-
AnyVideoMPMediaTypeAnyVideoЕсли установлено, элемент носителей содержит неуказанный тип видеоконтента.
Доступный в iOS 5.0 и позже.
-
AnyMPMediaTypeAnyЕсли установлено, элемент носителей содержит неуказанный тип аудио.
Доступный в iOS 3.0 и позже.
Оператор импорта
Objective C
@import MediaPlayer;Swift
import MediaPlayerДоступность
Доступный в iOS 3.0 и позже.
-
-
Вы получаете метаданные для элемента носителей путем вызова
valueForPropertyметод с этими ключами свойства. Некоторые свойства могут также использоваться для создания предикатов свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate. Эти свойства отмечены здесь как поддающиеся фильтрованию.Объявление
Swift
let MPMediaItemPropertyPersistentID: String let MPMediaItemPropertyAlbumPersistentID: String let MPMediaItemPropertyArtistPersistentID: String let MPMediaItemPropertyAlbumArtistPersistentID: String let MPMediaItemPropertyGenrePersistentID: String let MPMediaItemPropertyComposerPersistentID: String let MPMediaItemPropertyPodcastPersistentID: String let MPMediaItemPropertyMediaType: String let MPMediaItemPropertyTitle: String let MPMediaItemPropertyAlbumTitle: String let MPMediaItemPropertyArtist: String let MPMediaItemPropertyAlbumArtist: String let MPMediaItemPropertyGenre: String let MPMediaItemPropertyComposer: String let MPMediaItemPropertyPlaybackDuration: String let MPMediaItemPropertyAlbumTrackNumber: String let MPMediaItemPropertyAlbumTrackCount: String let MPMediaItemPropertyDiscNumber: String let MPMediaItemPropertyDiscCount: String let MPMediaItemPropertyArtwork: String let MPMediaItemPropertyLyrics: String let MPMediaItemPropertyIsCompilation: String let MPMediaItemPropertyReleaseDate: String let MPMediaItemPropertyBeatsPerMinute: String let MPMediaItemPropertyComments: String let MPMediaItemPropertyAssetURL: String let MPMediaItemPropertyIsCloudItem: StringObjective C
NSString *const MPMediaItemPropertyPersistentID ; // filterable NSString *const MPMediaItemPropertyAlbumPersistentID ; // filterable NSString *const MPMediaItemPropertyArtistPersistentID ; // filterable NSString *const MPMediaItemPropertyAlbumArtistPersistentID ; // filterable NSString *const MPMediaItemPropertyGenrePersistentID ; // filterable NSString *const MPMediaItemPropertyComposerPersistentID ; // filterable NSString *const MPMediaItemPropertyPodcastPersistentID ; // filterable NSString *const MPMediaItemPropertyMediaType ; // filterable NSString *const MPMediaItemPropertyTitle ; // filterable NSString *const MPMediaItemPropertyAlbumTitle ; // filterable NSString *const MPMediaItemPropertyArtist ; // filterable NSString *const MPMediaItemPropertyAlbumArtist ; // filterable NSString *const MPMediaItemPropertyGenre ; // filterable NSString *const MPMediaItemPropertyComposer ; // filterable NSString *const MPMediaItemPropertyPlaybackDuration; NSString *const MPMediaItemPropertyAlbumTrackNumber; NSString *const MPMediaItemPropertyAlbumTrackCount; NSString *const MPMediaItemPropertyDiscNumber; NSString *const MPMediaItemPropertyDiscCount; NSString *const MPMediaItemPropertyArtwork; NSString *const MPMediaItemPropertyLyrics; NSString *const MPMediaItemPropertyIsCompilation ; // filterable NSString *const MPMediaItemPropertyReleaseDate; NSString *const MPMediaItemPropertyBeatsPerMinute; NSString *const MPMediaItemPropertyComments; NSString *const MPMediaItemPropertyAssetURL; NSString *const MPMediaItemPropertyIsCloudItem ; // filterableКонстанты
-
MPMediaItemPropertyPersistentIDПерсистентный идентификатор для элемента носителей. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyPersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyAlbumPersistentIDПерсистентный идентификатор для альбома. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyAlbumPersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyArtistPersistentIDПерсистентный идентификатор для художника. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyArtistPersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyAlbumArtistPersistentIDПерсистентный идентификатор для художника альбома. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyAlbumArtistPersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyGenrePersistentIDПерсистентный идентификатор для жанра. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyGenrePersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyComposerPersistentIDПерсистентный идентификатор для композитора. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyComposerPersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyPodcastPersistentIDПерсистентный идентификатор для аудиоподкаста. Значение
NSNumberобъект, содержащий auint64_t(без знака длинный длинный).Значение
MPMediaItemPropertyPodcastPersistentIDидентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 4.2 и позже.
-
MPMediaItemPropertyMediaTypeТип среды элемента носителей. Значение
NSNumberобъект, представляющийNSIntegerтип данных.NSIntegerзначение представляет немного полевого флага или набор флагов, от Флагов Типа изделия Носителей.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyTitleЗаголовок (или имя) элемента носителей. Это свойство не связано с
MPMediaItemPropertyAlbumTitleсвойство. ЗначениеNSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyAlbumTitleЗаголовок альбома, такой как “Живой На Марсе”, в противоположность заголовку отдельной песни на альбоме, таком как “Танец кратера (радио-редактирование)” (который Вы указываете использование
MPMediaItemPropertyTitleсвойство). ЗначениеNSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyArtistХудожник (и) выполнения для элемента носителей — который может варьироваться от основного художника для альбома, которому принадлежит элемент носителей. Например, если художником альбома является «Джозеф Фэйбл», художником для одной из песен в альбоме может быть “Джозеф Фэйбл, обладающий Томасом Смитсоном”. Значение
NSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyAlbumArtistОсновной художник выполнения для альбома в целом. Значение
NSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyGenreМузыкальный или пленочный жанр элемента носителей. Значение
NSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyComposerМузыкальный композитор для элемента носителей. Значение
NSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyPlaybackDurationДлительность воспроизведения элемента носителей. Значение
NSNumberобъект, представляющий продолжительность в секундах какNSTimeInterval.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyAlbumTrackNumberНомер дорожки элемента носителей, для элемента носителей, который является частью альбома. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyAlbumTrackCountЧисло дорожек в альбоме, содержащем элемент носителей. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Для приложения потоковой передачи аудио система обеспечивает значение по умолчанию
1для этого свойства.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyDiscNumberНомер диска элемента носителей, для элемента носителей, который является частью альбома мультидиска. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyDiscCountЧисло дисков в альбоме, содержащем элемент носителей. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyArtworkИзображение иллюстраций для элемента носителей. Значение является изображением элемента носителей, описанным в Ссылке класса MPMediaItemArtwork.
Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyLyricsЛирика для элемента носителей. Значение
NSStringобъект.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyIsCompilationБулево значение, указывающее, является ли элемент носителей частью компиляции (
YEStrue), или не (NOfalse). Соответствует флажку «Part of a compilation» на вкладке Info в Получить Информационном диалоговом окне в iTunes. ЗначениеNSNumberобъект, представляющий aBOOLтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyReleaseDateДата, на которую был сначала публично выпущен элемент носителей. Значение
NSDateобъект.Доступный в iOS 4.0 и позже.
-
MPMediaItemPropertyBeatsPerMinuteЧисло музыкальных ударов в минуту для элемента носителей, соответствуя полю «BPM» на вкладке Info в Получить Информационном диалоговом окне в iTunes. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 4.0 и позже.
-
MPMediaItemPropertyCommentsТекстовая информация об элементе носителей, соответствуя полю «Comments» в на вкладке Info в Получить Информационном диалоговом окне в iTunes. Значение
NSStringобъект.Доступный в iOS 4.0 и позже.
-
MPMediaItemPropertyAssetURLURL ТО, указывающее на элемент носителей, от который
AVAssetобъект (или другой ОСНОВАННЫЙ НА URL объект Основы AV) могут быть созданы с любыми опциями, как желаемый. ЗначениеNSURLобъект.URL имеет пользовательскую схему
ipod-library. Например, URL мог бы быть похожим на это:ipod-library://item/item.m4a?id=12345
Использование URL за пределами платформы Основы AV не поддерживается.
Доступный в iOS 4.0 и позже.
-
MPMediaItemPropertyIsCloudItemБулево значение, указывающее, является ли элемент носителей элементом iCloud (
YEStrue), или не (NOfalse). Элемент носителей считают элементом iCloud, если это доступно через Соответствие iTunes и не уже сохранено на устройстве. ЗначениеNSNumberобъект, представляющий aBOOLтип данных.Доступный в iOS 6.0 и позже.
-
-
Вы получаете метаданные для элемента носителей подкаста путем вызова
valueForPropertyметод с этими ключами свойства. Так называемые поддающиеся фильтрованию свойства могут также использоваться для создания предикатов свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.Объявление
Swift
let MPMediaItemPropertyPodcastTitle: StringObjective C
NSString *const MPMediaItemPropertyPodcastTitle ; // filterableКонстанты
-
MPMediaItemPropertyPodcastTitleЗаголовок подкаста, такого как “Эта марсианская Тяжелая работа”, в противоположность заголовку отдельного эпизода подкаста, такого как “Эпизод 12: Другой Холодный День В полюсе” (который Вы указываете использование
MPMediaItemPropertyTitleсвойство). ЗначениеNSStringобъект.Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.
Доступный в iOS 3.0 и позже.
-
-
Вы получаете определяемые пользователем метаданные для элемента носителей путем вызова
valueForProperty:метод с этими ключами свойства. Определяемые пользователем свойства не могут использоваться для создания предикатов свойства носителей.Объявление
Swift
let MPMediaItemPropertyPlayCount: String let MPMediaItemPropertySkipCount: String let MPMediaItemPropertyRating: String let MPMediaItemPropertyLastPlayedDate: String let MPMediaItemPropertyUserGrouping: String let MPMediaItemPropertyBookmarkTime: StringObjective C
NSString *const MPMediaItemPropertyPlayCount; NSString *const MPMediaItemPropertySkipCount; NSString *const MPMediaItemPropertyRating; NSString *const MPMediaItemPropertyLastPlayedDate; NSString *const MPMediaItemPropertyUserGrouping; NSString *const MPMediaItemPropertyBookmarkTime;Константы
-
MPMediaItemPropertyPlayCountЧисло раз пользователь играло элемент носителей. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertySkipCountЧисло раз пользователь пропустило игру элемента. Значение
NSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyRatingУказанная пользователями оценка объекта в диапазоне
[0...5], где значение5указывает самую благоприятную оценку. ЗначениеNSNumberобъект, представляющийNSUIntegerтип данных.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyLastPlayedDateНовая календарная дата, на которую пользователь играл элемент носителей. Значение
NSDateобъект.Доступный в iOS 3.0 и позже.
-
MPMediaItemPropertyUserGroupingСоответствует полю «Grouping» на вкладке Info в Получить Информационном диалоговом окне в iTunes. Значение
NSStringобъект.Доступный в iOS 4.0 и позже.
-
MPMediaItemPropertyBookmarkTimeМесто пользователя в элементе носителей новое время это игралось. Значение
NSNumberобъект, представляющий продолжительность в секундах какNSTimeInterval.Доступный в iOS 6.0 и позже.
-
