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;
Константы
-
Music
MPMediaTypeMusic
Если установлено, элемент носителей содержит музыку.
Доступный в iOS 3.0 и позже.
-
Podcast
MPMediaTypePodcast
Если установлено, элемент носителей содержит подкаст.
Доступный в iOS 3.0 и позже.
-
AudioBook
MPMediaTypeAudioBook
Если установлено, элемент носителей содержит аудиокнигу.
Доступный в iOS 3.0 и позже.
-
AnyAudio
MPMediaTypeAnyAudio
Если установлено, элемент носителей содержит неуказанный тип звукового содержимого.
Доступный в iOS 3.0 и позже.
-
Movie
MPMediaTypeMovie
Если установлено, элемент носителей содержит фильм.
Доступный в iOS 5.0 и позже.
-
TVShow
MPMediaTypeTVShow
Если установлено, элемент носителей содержит сериал.
Доступный в iOS 5.0 и позже.
-
VideoPodcast
MPMediaTypeVideoPodcast
Если установлено, элемент носителей содержит видеоподкаст.
Доступный в iOS 5.0 и позже.
-
MusicVideo
MPMediaTypeMusicVideo
Если установлено, элемент носителей содержит музыкальное видео.
Доступный в iOS 5.0 и позже.
-
VideoITunesU
MPMediaTypeVideoITunesU
Если установлено, элемент носителей содержит видео iTunes U.
Доступный в iOS 5.0 и позже.
-
AnyVideo
MPMediaTypeAnyVideo
Если установлено, элемент носителей содержит неуказанный тип видеоконтента.
Доступный в iOS 5.0 и позже.
-
Any
MPMediaTypeAny
Если установлено, элемент носителей содержит неуказанный тип аудио.
Доступный в 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: String
Objective 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
Булево значение, указывающее, является ли элемент носителей частью компиляции (
YES
true
), или не (NO
false
). Соответствует флажку «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 и позже.
-
MPMediaItemPropertyAssetURL
URL ТО, указывающее на элемент носителей, от который
AVAsset
объект (или другой ОСНОВАННЫЙ НА URL объект Основы AV) могут быть созданы с любыми опциями, как желаемый. ЗначениеNSURL
объект.URL имеет пользовательскую схему
ipod-library
. Например, URL мог бы быть похожим на это:ipod-library://item/item.m4a?id=12345
Использование URL за пределами платформы Основы AV не поддерживается.
Доступный в iOS 4.0 и позже.
-
MPMediaItemPropertyIsCloudItem
Булево значение, указывающее, является ли элемент носителей элементом iCloud (
YES
true
), или не (NO
false
). Элемент носителей считают элементом iCloud, если это доступно через Соответствие iTunes и не уже сохранено на устройстве. ЗначениеNSNumber
объект, представляющий aBOOL
тип данных.Доступный в iOS 6.0 и позже.
-
-
Вы получаете метаданные для элемента носителей подкаста путем вызова
valueForProperty
метод с этими ключами свойства. Так называемые поддающиеся фильтрованию свойства могут также использоваться для создания предикатов свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.Объявление
Swift
let MPMediaItemPropertyPodcastTitle: String
Objective 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: String
Objective 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 и позже.
-