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

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

Разработчик

Ссылка платформы AVFoundation ссылка класса AVAsset

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

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

AVAsset

AVAsset абстрактный класс для представления синхронизированных аудиовизуальных носителей, таких как видео и звуки. Каждый актив содержит набор дорожек, предназначающихся, чтобы быть представленными или обработанными вместе, каждый универсальный тип среды, включая, но не ограничиваясь этим, аудио, видео, текст, субтитры и подзаголовки.

AVAsset объект определяет коллективные свойства дорожек, включающих актив. (Можно получить доступ к экземплярам AVAssetTrack представление дорожек набора, таким образом, можно исследовать каждый из них независимо, если Вы должны.)

Вы часто инстанцируете использования актива AVURLAsset— конкретный подкласс AVAsset— с NSURLs, относящимися к аудиовизуальным медиаресурсам, таким как потоки (включая прямые трансляции HTTP), файлы фильма в формате QuickTime, файлы MP3 и файлы других типов. Можно также инстанцировать актива с помощью других конкретных подклассов, расширяющих базовую модель для аудиовизуальных носителей полезными способами, как AVComposition делает для временного редактирования.

Свойства активов в целом определяются AVAsset. Кроме того, ссылки на экземпляры AVAssetTrack представление дорожек набора может быть получено, так, чтобы каждый из них мог быть исследован независимо.

Из-за природы синхронизированных аудиовизуальных носителей на успешную инициализацию актива некоторые или все значения для его ключей могут не быть сразу доступными. В любое время значение любого ключа можно требовать, и актив всегда возвращает свое значение синхронно, несмотря на то, что этому, вероятно, придется блокировать вызывающий поток, чтобы сделать так. Когда их значения становятся доступными, во избежание блокирования можно зарегистрировать интерес к определенным ключам и стать уведомленными. Для получения дальнейшей информации посмотрите AVAsynchronousKeyValueLoading.

Играть экземпляр AVAsset, инициализируйте экземпляр AVPlayerItem с ним используйте элемент проигрывателя для установки его состояния представления (такой как, должен ли только ограниченный timeRange актива играться, и т.д.), и обеспечьте элемент проигрывателя для AVPlayer объект согласно тому, должны ли элементы играться отдельно или вместе с набором других элементов.

Можно вставить AVAsset объекты в AVMutableComposition возразите для сборки аудиовизуальных конструкций от одного или более исходных активов.

Разделение на подклассы примечаний

Не в настоящее время возможно разделить на подклассы AVAsset обработать протоколы потоковой передачи или форматы файлов, не поддерживающиеся платформой.

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


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


Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность


Доступный в OS X v10.7 и позже.
  • Возвращает актив для проверки медиаресурса.

    Объявление

    Swift

    class func assetWithURL(_ URL: NSURL!) -> AnyObject!

    Objective C

    + (id)assetWithURL:(NSURL *)URL

    Параметры

    URL

    URL это ссылается на медиаресурс.

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

    Экземпляр подкласса AVAsset инициализированный с URL.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Отменяет загрузку всех значений для всех наблюдателей.

    Объявление

    Swift

    func cancelLoading()

    Objective C

    - (void)cancelLoading

    Обсуждение

    Если какие-либо запросы загрузки являются все еще выдающимися, освобождение экземпляра актива неявно вызывает этот метод.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • commonMetadata commonMetadata Свойство

    Массив элементов метаданных для каждого общего ключа метаданных, для которого значение доступно. (только для чтения)

    Объявление

    Swift

    var commonMetadata: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *commonMetadata

    Обсуждение

    Значение является массивом AVMetadataItem объекты, один для каждого ключа метаданных от общего ключевого пространства, для которого актив имеет доступное значение. Можно отфильтровать массив использованием локали metadataItemsFromArray:withLocale: (AVMetadataItem) или ключевым использованием metadataItemsFromArray:withKey:keySpace: (AVMetadataItem).

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Массив строк, каждый представляющий метаданные форматирует, это доступно активу. (только для чтения)

    Объявление

    Swift

    var availableMetadataFormats: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *availableMetadataFormats

    Обсуждение

    Форматы метаданных могут включать ID3, метаданные iTunes, и т.д. Для получения дополнительной информации посмотрите AVMetadataItem.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает массив AVMetadataItem объекты, один для каждого элемента метаданных в контейнере указанного формата

    Объявление

    Swift

    func metadataForFormat(_ format: String!) -> [AnyObject]!

    Objective C

    - (NSArray *)metadataForFormat:(NSString *)format

    Параметры

    format

    Метаданные форматируют, для которого Вы хотите элементы.

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

    Массив AVMetadataItem объекты, один для каждого элемента метаданных в контейнере указанного формата, или nil при отсутствии метаданных указанного формата.

    Обсуждение

    Можно отфильтровать массив локалью с помощью AVMetadataItem метод metadataItemsFromArray:withLocale: или ключом с помощью AVMetadataItem метод metadataItemsFromArray:withKey:keySpace:. Посмотрите AVMetadataItemFilter и AVMetadataItem классы для дополнительных методов для фильтрации.

    Специальные замечания

    Этот метод становится вызываемым, не блокируя когда данные в availableMetadataFormats свойство уже загружается.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • лирика лирика Свойство

    Лирика актива, подходящего для текущей локали. (только для чтения)

    Объявление

    Swift

    var lyrics: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *lyrics

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Локали, доступные для глав в активе. (только для чтения)

    Объявление

    Swift

    var availableChapterLocales: [AnyObject]! { get }

    Objective C

    @property(readonly) NSArray *availableChapterLocales

    Обсуждение

    Массив содержит экземпляры NSLocale.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает массив глав с данной локалью заголовка и содержащий указанные ключи.

    Объявление

    Swift

    func chapterMetadataGroupsWithTitleLocale(_ locale: NSLocale!, containingItemsWithCommonKeys commonKeys: [AnyObject]!) -> [AnyObject]!

    Objective C

    - (NSArray *)chapterMetadataGroupsWithTitleLocale:(NSLocale *)locale containingItemsWithCommonKeys:(NSArray *)commonKeys

    Параметры

    locale

    Локаль элементов метаданных, носящих названия главы, которые будут возвращены (метод поддерживает спецификацию IETF BCP 47 локалей).

    commonKeys

    Массив общих ключей AVMetadataItem включать в возвращенный массив. AVMetadataCommonKeyArtwork единственный поддерживаемый ключ.

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

    Массив AVTimedMetadataGroup объекты.

    Обсуждение

    Каждый объект в возвращенном массиве содержит AVMetadataItem объект, представляющий заголовок главы и свойство диапазона времени AVTimedMetadataGroup объект равен диапазону времени элемента заголовка главы.

    AVMetadataItem с указанным общим ключом добавляется к существующему AVTimedMetadataGroup возразите если диапазон времени (метка времени и продолжительность) элемента метаданных и перекрытия группы метаданных.

    Локаль элементов, не переносящих заголовки главы, не должна соответствовать указанный параметр локали. Можно отфильтровать возвращенные элементы на основе использования локали metadataItemsFromArray:withLocale:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает массив глав, локаль которых лучше всего соответствует список предпочтительных языков.

    Объявление

    Swift

    func chapterMetadataGroupsBestMatchingPreferredLanguages(_ preferredLanguages: [AnyObject]!) -> [AnyObject]!

    Objective C

    - (NSArray *)chapterMetadataGroupsBestMatchingPreferredLanguages:(NSArray *)preferredLanguages

    Параметры

    preferredLanguages

    Массив NSString объекты, каждый из которых содержит канонический идентификатор IETF BCP 47 языка. Порядок идентификаторов в массиве отражает предпочтительный порядок языка с самым предпочтительным языком, находящимся первым в массиве. Как правило, Вы передаете предпочтительные языки пользователя путем получения этого массива от preferredLanguages метод класса NSLocale.

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

    Массив AVTimedMetadataGroup объекты.

    Обсуждение

    Каждый объект в возвращенном массиве содержит AVMetadataItem объект, представляющий заголовок главы. Свойство диапазона времени AVTimedMetadataGroup объект равен диапазону времени элемента заголовка главы.

    Все доступные метаданные главы включены в группы метаданных, включая элементы с общим ключом AVMetadataCommonKeyArtwork, если присутствуют такие элементы. Элементы, не носящие названия главы, добавляются к существующему AVTimedMetadataGroup возразите если диапазон времени (метка времени и продолжительность) элемента метаданных и того из перекрытий группы метаданных. Локаль таких элементов не должна соответствовать локаль заголовков главы.

    Можно использовать metadataItemsFromArray:filteredAndSortedAccordingToPreferredLanguages: метод для дальнейшей фильтрации элементов метаданных в каждой группе. Можно также отфильтровать возвращенные элементы на основе локали с помощью metadataItemsFromArray:withLocale: метод.

    Специальные замечания

    Становится вызываемым, не блокируя когда данные в availableChapterLocales свойство уже загружается.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.8 и позже.

  • дорожки дорожки Свойство

    Дорожки содержатся активом. (только для чтения)

    Объявление

    Swift

    var tracks: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *tracks

    Обсуждение

    Дорожки являются экземплярами AVAssetTrack.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает дорожку с указанной дорожкой ID.

    Объявление

    Swift

    func trackWithTrackID(_ trackID: CMPersistentTrackID) -> AVAssetTrack!

    Objective C

    - (AVAssetTrack *)trackWithTrackID:(CMPersistentTrackID)trackID

    Параметры

    trackID

    trackID требуемой дорожки актива.

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

    Дорожка с дорожкой ID trackID, или nil если никакая дорожка с указанным ID не доступна.

    Обсуждение

    Можно вызвать этот метод, не блокируя когда данные в tracks свойство уже загружается.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает массив AVAssetTrack объекты актива, дарящие носителям заданную характеристику.

    Объявление

    Swift

    func tracksWithMediaCharacteristic(_ mediaCharacteristic: String!) -> [AnyObject]!

    Objective C

    - (NSArray *)tracksWithMediaCharacteristic:(NSString *)mediaCharacteristic

    Параметры

    mediaCharacteristic

    Характеристика носителей, согласно которой получатель фильтрует свои дорожки актива.

    Для допустимых значений посмотрите Media Characteristics.

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

    Массив AVAssetTrack объекты тот существующие носители с mediaCharacteristic, или пустой массив, если никакие дорожки с заданной характеристикой не доступны.

    Обсуждение

    Можно вызвать этот метод, не блокируя когда данные в tracks свойство уже загружается.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает массив дорожек актива актива, представляющих носители указанного типа.

    Объявление

    Swift

    func tracksWithMediaType(_ mediaType: String!) -> [AnyObject]!

    Objective C

    - (NSArray *)tracksWithMediaType:(NSString *)mediaType

    Параметры

    mediaType

    Тип среды, согласно которому актив фильтрует свои дорожки.

    Типы среды определяются в AVAssetTrack.

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

    Массив AVAssetTrack объекты актива тот существующие носители mediaType.

    Обсуждение

    Можно вызвать этот метод, не блокируя когда данные в tracks свойство уже загружается.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • trackGroups trackGroups Свойство

    Массив, содержащий все группы дорожки в активе. (только для чтения)

    Объявление

    Swift

    var trackGroups: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *trackGroups

    Обсуждение

    Это - массив AVAssetTrackGroup экземпляры, каждый представляющий различную группировку дорожек в активе.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.9 и позже.

  • Булево значение, указывающее, защитил ли актив содержание. (только для чтения)

    Объявление

    Swift

    var hasProtectedContent: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL hasProtectedContent

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Указывает, может ли актив или его URL, использоваться для инициализации экземпляра AVPlayerItem. (только для чтения)

    Объявление

    Swift

    var playable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isPlayable) BOOL playable

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Булево значение, указывающее, может ли актив быть экспортирован с помощью AVAssetExportSession. (только для чтения)

    Объявление

    Swift

    var exportable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isExportable) BOOL exportable

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Булево значение, указывающее, могут ли данные носителей актива быть извлечены с помощью AVAssetReader. (только для чтения)

    Объявление

    Swift

    var readable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isReadable) BOOL readable

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • composable composable Свойство

    Булево значение, указывающее, может ли актив использоваться в сегменте AVCompositionTrack объект. (только для чтения)

    Объявление

    Swift

    var composable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isComposable) BOOL composable

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает ID, который в настоящее время не использован любой из дорожек в активе.

    Объявление

    Swift

    func unusedTrackID() -> CMPersistentTrackID

    Objective C

    - (CMPersistentTrackID)unusedTrackID

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    var metadata: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *metadata

    Обсуждение

    Массив AVMetadataItem экземпляры могут быть отфильтрованы согласно языку с помощью metadataItemsFromArray:filteredAndSortedAccordingToPreferredLanguages: метод. Они могут быть отфильтрованы идентификатором с помощью metadataItemsFromArray:filteredByIdentifier: метод.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.10 и позже.

  • Продолжительность актива. (только для чтения)

    Объявление

    Swift

    var duration: CMTime { get }

    Objective C

    @property(nonatomic, readonly) CMTime duration

    Обсуждение

    Если providesPreciseDurationAndTiming NOfalse, возвращается наилучшая имеющаяся оценка продолжительности. Можно установить степень точности, требуемой для связанных с синхронизацией свойств во время инициализации для активов, инициализированных с URLs (см. AVURLAssetPreferPreciseDurationAndTimingKey в AVURLAsset).

    Если providesPreciseDurationAndTiming YEStrue абсолютная точность, по любой стоимости обработки, влекущей за собой – и стоимость, может быть значительной для определенных форматов носителя, такой как .mpg. Если providesPreciseDurationAndTiming установлен в NOfalse, баланс между точностью и обработкой стоимости возвращается как duration. Установка providesPreciseDurationAndTiming свойство к NOfalseвсегда достаточно для типичных сценариев воспроизведения, и в этом случае для некоторых форматов носителя, таков как .mov и .mp4, точность является абсолютной так или иначе.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Булево значение, указывающее, обеспечивает ли актив точную синхронизацию. (только для чтения)

    Объявление

    Swift

    var providesPreciseDurationAndTiming: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL providesPreciseDurationAndTiming

    Обсуждение

    Можно установить степень точности, требуемой для связанных с синхронизацией свойств во время инициализации для активов, инициализированных с URLs (см. AVURLAssetPreferPreciseDurationAndTimingKey в AVURLAsset).

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • naturalSize naturalSize (OS X v10.8) Свойство

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

    Оператор осуждения

    Используйте naturalSize и preferredTransform, как надлежащий, видеотреков актива вместо этого (см. также tracksWithMediaType:).

    Объявление

    Objective C

    @property(nonatomic, readonly) CGSize naturalSize

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

    Objective C

    @import AVFoundation;

    Доступность

    Доступный в OS X v10.7 и позже.

    Осуждаемый в OS X v10.8.

  • preferredRate preferredRate Свойство

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

    Объявление

    Swift

    var preferredRate: Float { get }

    Objective C

    @property(nonatomic, readonly) float preferredRate

    Обсуждение

    Это значение часто, но не всегда, 1.0.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Предпочтительное преобразование для применения к визуальному содержанию актива для представления или обработки. (только для чтения)

    Объявление

    Swift

    var preferredTransform: CGAffineTransform { get }

    Objective C

    @property(nonatomic, readonly) CGAffineTransform preferredTransform

    Обсуждение

    Значение часто, но не всегда, идентификационные данные преобразовывают.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • preferredVolume preferredVolume Свойство

    Предпочтительный объем, в котором слышимые носители актива должен играться. (только для чтения)

    Объявление

    Swift

    var preferredVolume: Float { get }

    Objective C

    @property(nonatomic, readonly) float preferredVolume

    Обсуждение

    Это значение часто, но не всегда, 1.0.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Массив характеристик носителей, для которых опция выбора носителей доступна. (только для чтения)

    Объявление

    Swift

    var availableMediaCharacteristicsWithMediaSelectionOptions: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *availableMediaCharacteristicsWithMediaSelectionOptions

    Обсуждение

    Значение этого свойства является массивом NSString объекты, каждая строка, указывающая характеристику носителей, для которой опция выбора носителей доступна.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.8 и позже.

  • Возвраты AVMediaSelectionGroup объект, содержащий одну или более опций с указанной характеристикой носителей.

    Объявление

    Swift

    func mediaSelectionGroupForMediaCharacteristic(_ mediaCharacteristic: String!) -> AVMediaSelectionGroup!

    Objective C

    - (AVMediaSelectionGroup *)mediaSelectionGroupForMediaCharacteristic:(NSString *)mediaCharacteristic

    Параметры

    mediaCharacteristic

    Характеристика носителей, для которой Вы хотите получить доступные опции выбора носителей.

    Только AVMediaCharacteristicAudible, AVMediaCharacteristicVisual, и AVMediaCharacteristicLegible в настоящее время поддерживаются.

    • Передача AVMediaCharacteristicAudible получить группу доступных параметров для аудио носителей на различных языках и в различных целях, таких как дескриптивное аудио.

    • Передача AVMediaCharacteristicLegible получить группу доступных параметров для подзаголовков на различных языках и в различных целях.

    • Передача AVMediaCharacteristicVisual получить группу доступных параметров для видео носителей.

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

    AVMediaSelectionGroup объект, содержащий одну или более опций с характеристикой носителей, указанной mediaCharacteristic, или nil если ни один не мог бы быть найден.

    Обсуждение

    Можно вызвать этот метод, не блокируя когда ключ availableMediaCharacteristicsWithMediaSelectionOptions был загружен.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.8 и позже.

  • creationDate creationDate Свойство

    Указывает дату создания актива. (только для чтения)

    Объявление

    Swift

    var creationDate: AVMetadataItem! { get }

    Objective C

    @property(nonatomic, readonly) AVMetadataItem *creationDate

    Обсуждение

    Значение этого свойства может быть nil.

    Если дата создания была сохранена активом в форме, которая может быть преобразована в NSDate объект, dateValue свойство элемента метаданных обеспечивает экземпляр NSDate. Иначе дата создания доступна только как строковое значение, с помощью AVMetadataItem класс stringValue метод.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.8 и позже.