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

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

Разработчик

Ссылка платформы MediaPlayer ссылка класса MPMediaItem

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

На этой странице
Язык:

MPMediaItem

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


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


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(rawValue rawValue: 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 объект, содержащий a uint64_t (без знака длинный длинный).

      Значение MPMediaItemPropertyPersistentID идентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.

      Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.

      Доступный в iOS 4.2 и позже.

    • MPMediaItemPropertyAlbumPersistentID

      Персистентный идентификатор для альбома. Значение NSNumber объект, содержащий a uint64_t (без знака длинный длинный).

      Значение MPMediaItemPropertyAlbumPersistentID идентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.

      Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.

      Доступный в iOS 4.2 и позже.

    • MPMediaItemPropertyArtistPersistentID

      Персистентный идентификатор для художника. Значение NSNumber объект, содержащий a uint64_t (без знака длинный длинный).

      Значение MPMediaItemPropertyArtistPersistentID идентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.

      Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.

      Доступный в iOS 4.2 и позже.

    • MPMediaItemPropertyAlbumArtistPersistentID

      Персистентный идентификатор для художника альбома. Значение NSNumber объект, содержащий a uint64_t (без знака длинный длинный).

      Значение MPMediaItemPropertyAlbumArtistPersistentID идентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.

      Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.

      Доступный в iOS 4.2 и позже.

    • MPMediaItemPropertyGenrePersistentID

      Персистентный идентификатор для жанра. Значение NSNumber объект, содержащий a uint64_t (без знака длинный длинный).

      Значение MPMediaItemPropertyGenrePersistentID идентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.

      Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.

      Доступный в iOS 4.2 и позже.

    • MPMediaItemPropertyComposerPersistentID

      Персистентный идентификатор для композитора. Значение NSNumber объект, содержащий a uint64_t (без знака длинный длинный).

      Значение MPMediaItemPropertyComposerPersistentID идентификатор сохраняется через запуски приложения и через синхронизации, не изменяющие синхронизирующее состояние элемента носителей. Значение, как гарантируют, не сохранится через синхронизирующий/несинхронизирующий/синхронизирующий цикл.

      Может использоваться для создания предиката свойства носителей, как описано в Ссылке класса MPMediaPropertyPredicate.

      Доступный в iOS 4.2 и позже.

    • MPMediaItemPropertyPodcastPersistentID

      Персистентный идентификатор для аудиоподкаста. Значение NSNumber объект, содержащий a uint64_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 объект, представляющий a BOOL тип данных.

      Доступный в 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 (YEStrue), или не (NOfalse). Элемент носителей считают элементом iCloud, если это доступно через Соответствие iTunes и не уже сохранено на устройстве. Значение NSNumber объект, представляющий a BOOL тип данных.

      Доступный в 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 и позже.