AVAsset
Соответствует
-
AVAsynchronousKeyValueLoading
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCopying
-
NSObjectProtocol
-
Печатаемый
-
AVAsynchronousKeyValueLoading
-
NSCopying
-
NSObject
Оператор импорта
Swift
import AVFoundation
Objective C
@import AVFoundation;
Доступность
Доступный в iOS 4.0 и позже.
AVAsset
абстрактный класс для представления синхронизированных аудиовизуальных носителей, таких как видео и звуки. Каждый актив содержит набор дорожек, предназначающихся, чтобы быть представленными или обработанными вместе, каждый универсальный тип среды, включая, но не ограничиваясь этим, аудио, видео, текст, субтитры и подзаголовки.
AVAsset
объект определяет коллективные свойства дорожек, включающих актив. (Можно получить доступ к экземплярам AVAssetTrack
представление дорожек набора, таким образом, можно исследовать каждый из них независимо, если Вы должны.)
Вы часто инстанцируете использования актива AVURLAsset
— конкретный подкласс AVAsset
— с NSURLs, относящимися к аудиовизуальным медиаресурсам, таким как потоки (включая прямые трансляции HTTP), файлы фильма в формате QuickTime, файлы MP3 и файлы других типов. Можно также инстанцировать актива с помощью других конкретных подклассов, расширяющих базовую модель для аудиовизуальных носителей полезными способами, как AVComposition
делает для временного редактирования.
Свойства активов в целом определяются AVAsset
. Кроме того, ссылки на экземпляры AVAssetTrack
представление дорожек набора может быть получено, так, чтобы каждый из них мог быть исследован независимо.
Из-за природы синхронизированных аудиовизуальных носителей на успешную инициализацию актива некоторые или все значения для его ключей могут не быть сразу доступными. В любое время значение любого ключа можно требовать, и актив всегда возвращает свое значение синхронно, несмотря на то, что этому, вероятно, придется блокировать вызывающий поток, чтобы сделать так. Когда их значения становятся доступными, во избежание блокирования можно зарегистрировать интерес к определенным ключам и стать уведомленными. Для получения дальнейшей информации посмотрите AVAsynchronousKeyValueLoading
.
Играть экземпляр AVAsset
, инициализируйте экземпляр AVPlayerItem
с ним используйте элемент проигрывателя для установки его состояния представления (такой как, должен ли только ограниченный timeRange актива играться, и т.д.), и обеспечьте элемент проигрывателя для AVPlayer
объект согласно тому, должны ли элементы играться отдельно или вместе с набором других элементов.
Можно вставить AVAsset
объекты в AVMutableComposition
возразите для сборки аудиовизуальных конструкций от одного или более исходных активов.
Разделение на подклассы примечаний
Не в настоящее время возможно разделить на подклассы AVAsset
обработать протоколы потоковой передачи или форматы файлов, не поддерживающиеся платформой.
-
Возвращает актив для проверки медиаресурса.
Объявление
Swift
class func assetWithURL(_
URL
: NSURL!) -> AnyObject!Objective C
+ (id)assetWithURL:(NSURL *)
URL
Параметры
URL
URL это ссылается на медиаресурс.
Возвращаемое значение
Экземпляр подкласса
AVAsset
инициализированный сURL
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 5.0 и позже.
-
Отменяет загрузку всех значений для всех наблюдателей.
Объявление
Swift
func cancelLoading()
Objective C
- (void)cancelLoading
Обсуждение
Если какие-либо запросы загрузки являются все еще выдающимися, освобождение экземпляра актива неявно вызывает этот метод.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
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
Доступность
Доступный в iOS 4.0 и позже.
-
availableMetadataFormats
СвойствоМассив строк, каждый представляющий метаданные форматирует, это доступно активу. (только для чтения)
Объявление
Swift
var availableMetadataFormats: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *availableMetadataFormats
Обсуждение
Форматы метаданных могут включать ID3, метаданные iTunes, и т.д. Для получения дополнительной информации посмотрите
AVMetadataItem
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив
AVMetadataItem
объекты, один для каждого элемента метаданных в контейнере указанного форматаОбъявление
Swift
func metadataForFormat(_
format
: String!) -> [AnyObject]!Параметры
format
Метаданные форматируют, для которого Вы хотите элементы.
Возвращаемое значение
Массив
AVMetadataItem
объекты, один для каждого элемента метаданных в контейнере указанного формата, илиnil
при отсутствии метаданных указанного формата.Обсуждение
Можно отфильтровать массив локалью с помощью
AVMetadataItem
методmetadataItemsFromArray:withLocale:
или ключом с помощьюAVMetadataItem
методmetadataItemsFromArray:withKey:keySpace:
. ПосмотритеAVMetadataItemFilter
иAVMetadataItem
классы для дополнительных методов для фильтрации.Специальные замечания
Этот метод становится вызываемым, не блокируя когда данные в
availableMetadataFormats
свойство уже загружается.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
lyrics
Свойство -
availableChapterLocales
СвойствоЛокали, доступные для глав в активе. (только для чтения)
Объявление
Swift
var availableChapterLocales: [AnyObject]! { get }
Objective C
@property(readonly) NSArray *availableChapterLocales
Обсуждение
Массив содержит экземпляры
NSLocale
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.3 и позже.
-
chapterMetadataGroupsWithTitleLocale (_: containingItemsWithCommonKeys:) - chapterMetadataGroupsWithTitleLocale:containingItemsWithCommonKeys:
Возвращает массив глав с данной локалью заголовка и содержащий указанные ключи.
Объявление
Swift
func chapterMetadataGroupsWithTitleLocale(_
locale
: NSLocale!, containingItemsWithCommonKeyscommonKeys
: [AnyObject]!) -> [AnyObject]!Параметры
locale
Локаль элементов метаданных, носящих названия главы, которые будут возвращены (метод поддерживает спецификацию IETF BCP 47 локалей).
commonKeys
Массив общих ключей
AVMetadataItem
включать в возвращенный массив.AVMetadataCommonKeyArtwork
единственный поддерживаемый ключ.Возвращаемое значение
Массив
AVTimedMetadataGroup
объекты.Обсуждение
Каждый объект в возвращенном массиве содержит
AVMetadataItem
объект, представляющий заголовок главы и свойство диапазона времениAVTimedMetadataGroup
объект равен диапазону времени элемента заголовка главы.AVMetadataItem
с указанным общим ключом добавляется к существующемуAVTimedMetadataGroup
возразите если диапазон времени (метка времени и продолжительность) элемента метаданных и перекрытия группы метаданных.Локаль элементов, не переносящих заголовки главы, не должна соответствовать указанный параметр локали. Можно отфильтровать возвращенные элементы на основе использования локали
metadataItemsFromArray:withLocale:
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.3 и позже.
-
chapterMetadataGroupsBestMatchingPreferredLanguages (_:) - chapterMetadataGroupsBestMatchingPreferredLanguages:
Возвращает массив глав, локаль которых лучше всего соответствует список предпочтительных языков.
Объявление
Swift
func chapterMetadataGroupsBestMatchingPreferredLanguages(_
preferredLanguages
: [AnyObject]!) -> [AnyObject]!Параметры
preferredLanguages
Массив
NSString
объекты, каждый из которых содержит канонический идентификатор IETF BCP 47 языка. Порядок идентификаторов в массиве отражает предпочтительный порядок языка с самым предпочтительным языком, находящимся первым в массиве. Как правило, Вы передаете предпочтительные языки пользователя путем получения этого массива отpreferredLanguages
метод классаNSLocale
.Возвращаемое значение
Массив
AVTimedMetadataGroup
объекты.Обсуждение
Каждый объект в возвращенном массиве содержит
AVMetadataItem
объект, представляющий заголовок главы. Свойство диапазона времениAVTimedMetadataGroup
объект равен диапазону времени элемента заголовка главы.Все доступные метаданные главы включены в группы метаданных, включая элементы с общим ключом
AVMetadataCommonKeyArtwork
, если присутствуют такие элементы. Элементы, не носящие названия главы, добавляются к существующемуAVTimedMetadataGroup
возразите если диапазон времени (метка времени и продолжительность) элемента метаданных и того из перекрытий группы метаданных. Локаль таких элементов не должна соответствовать локаль заголовков главы.Можно использовать
metadataItemsFromArray:filteredAndSortedAccordingToPreferredLanguages:
метод для дальнейшей фильтрации элементов метаданных в каждой группе. Можно также отфильтровать возвращенные элементы на основе локали с помощьюmetadataItemsFromArray:withLocale:
метод.Специальные замечания
Становится вызываемым, не блокируя когда данные в
availableChapterLocales
свойство уже загружается.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 6.0 и позже.
-
tracks
СвойствоДорожки содержатся активом. (только для чтения)
Объявление
Swift
var tracks: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *tracks
Обсуждение
Дорожки являются экземплярами
AVAssetTrack
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает дорожку с указанной дорожкой 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
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив
AVAssetTrack
объекты актива, дарящие носителям заданную характеристику.Объявление
Swift
func tracksWithMediaCharacteristic(_
mediaCharacteristic
: String!) -> [AnyObject]!Параметры
mediaCharacteristic
Характеристика носителей, согласно которой получатель фильтрует свои дорожки актива.
Для допустимых значений посмотрите
Media Characteristics
.Возвращаемое значение
Массив
AVAssetTrack
объекты тот существующие носители сmediaCharacteristic
, или пустой массив, если никакие дорожки с заданной характеристикой не доступны.Обсуждение
Можно вызвать этот метод, не блокируя когда данные в
tracks
свойство уже загружается.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив дорожек актива актива, представляющих носители указанного типа.
Объявление
Swift
func tracksWithMediaType(_
mediaType
: String!) -> [AnyObject]!Параметры
mediaType
Тип среды, согласно которому актив фильтрует свои дорожки.
Типы среды определяются в
AVAssetTrack
.Возвращаемое значение
Массив
AVAssetTrack
объекты актива тот существующие носителиmediaType
.Обсуждение
Можно вызвать этот метод, не блокируя когда данные в
tracks
свойство уже загружается.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
trackGroups
СвойствоМассив, содержащий все группы дорожки в активе. (только для чтения)
Объявление
Swift
var trackGroups: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *trackGroups
Обсуждение
Это - массив
AVAssetTrackGroup
экземпляры, каждый представляющий различную группировку дорожек в активе.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 7.0 и позже.
-
hasProtectedContent
СвойствоБулево значение, указывающее, защитил ли актив содержание. (только для чтения)
Объявление
Swift
var hasProtectedContent: Bool { get }
Objective C
@property(nonatomic, readonly) BOOL hasProtectedContent
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.2 и позже.
-
playable
СвойствоУказывает, может ли актив или его URL, использоваться для инициализации экземпляра
AVPlayerItem
. (только для чтения)Объявление
Swift
var playable: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isPlayable) BOOL playable
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.3 и позже.
-
exportable
СвойствоБулево значение, указывающее, может ли актив быть экспортирован с помощью
AVAssetExportSession
. (только для чтения)Объявление
Swift
var exportable: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isExportable) BOOL exportable
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.3 и позже.
-
readable
СвойствоБулево значение, указывающее, могут ли данные носителей актива быть извлечены с помощью
AVAssetReader
. (только для чтения)Объявление
Swift
var readable: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isReadable) BOOL readable
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.3 и позже.
-
composable
СвойствоБулево значение, указывающее, может ли актив использоваться в сегменте
AVCompositionTrack
объект. (только для чтения)Объявление
Swift
var composable: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isComposable) BOOL composable
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.3 и позже.
-
Возвращает ID, который в настоящее время не использован любой из дорожек в активе.
Объявление
Swift
func unusedTrackID() -> CMPersistentTrackID
Objective C
- (CMPersistentTrackID)unusedTrackID
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
metadata
СвойствоМассив элементов метаданных для всех идентификаторов метаданных, для которых значение доступно. (только для чтения)
Объявление
Swift
var metadata: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *metadata
Обсуждение
Массив
AVMetadataItem
экземпляры могут быть отфильтрованы согласно языку с помощьюmetadataItemsFromArray:filteredAndSortedAccordingToPreferredLanguages:
метод. Они могут быть отфильтрованы идентификатором с помощьюmetadataItemsFromArray:filteredByIdentifier:
метод.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 8.0 и позже.
-
duration
СвойствоПродолжительность актива. (только для чтения)
Объявление
Swift
var duration: CMTime { get }
Objective C
@property(nonatomic, readonly) CMTime duration
Обсуждение
Если
providesPreciseDurationAndTiming
NO
false
, возвращается наилучшая имеющаяся оценка продолжительности. Можно установить степень точности, требуемой для связанных с синхронизацией свойств во время инициализации для активов, инициализированных с URLs (см.AVURLAssetPreferPreciseDurationAndTimingKey
вAVURLAsset
).Если
providesPreciseDurationAndTiming
YES
true
абсолютная точность, по любой стоимости обработки, влекущей за собой – и стоимость, может быть значительной для определенных форматов носителя, такой как .mpg. ЕслиprovidesPreciseDurationAndTiming
установлен вNO
false
, баланс между точностью и обработкой стоимости возвращается какduration
. УстановкаprovidesPreciseDurationAndTiming
свойство кNO
false
всегда достаточно для типичных сценариев воспроизведения, и в этом случае для некоторых форматов носителя, таков как .mov и .mp4, точность является абсолютной так или иначе.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
providesPreciseDurationAndTiming
СвойствоБулево значение, указывающее, обеспечивает ли актив точную синхронизацию. (только для чтения)
Объявление
Swift
var providesPreciseDurationAndTiming: Bool { get }
Objective C
@property(nonatomic, readonly) BOOL providesPreciseDurationAndTiming
Обсуждение
Можно установить степень точности, требуемой для связанных с синхронизацией свойств во время инициализации для активов, инициализированных с URLs (см.
AVURLAssetPreferPreciseDurationAndTimingKey
вAVURLAsset
).Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
См. также
-
Закодированный или созданный размер визуальной части актива. (только для чтения)
Оператор осуждения
Используйте
naturalSize
иpreferredTransform
, как надлежащий, видеотреков актива вместо этого (см. такжеtracksWithMediaType:
).Объявление
Objective C
@property(nonatomic, readonly) CGSize naturalSize
Оператор импорта
Objective C
@import AVFoundation;
Доступность
Доступный в iOS 4.0 и позже.
Осуждаемый в iOS 5.0.
-
preferredRate
СвойствоЕстественный уровень, на котором должен играться актив. (только для чтения)
Объявление
Swift
var preferredRate: Float { get }
Objective C
@property(nonatomic, readonly) float preferredRate
Обсуждение
Это значение часто, но не всегда,
1.0
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
preferredTransform
СвойствоПредпочтительное преобразование для применения к визуальному содержанию актива для представления или обработки. (только для чтения)
Объявление
Swift
var preferredTransform: CGAffineTransform { get }
Objective C
@property(nonatomic, readonly) CGAffineTransform preferredTransform
Обсуждение
Значение часто, но не всегда, идентификационные данные преобразовывают.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
preferredVolume
СвойствоПредпочтительный объем, в котором слышимые носители актива должен играться. (только для чтения)
Объявление
Swift
var preferredVolume: Float { get }
Objective C
@property(nonatomic, readonly) float preferredVolume
Обсуждение
Это значение часто, но не всегда,
1.0
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
-
referenceRestrictions
СвойствоСсылочные ограничения, используемые получателем. (только для чтения)
Объявление
Swift
var referenceRestrictions: AVAssetReferenceRestrictions { get }
Objective C
@property(nonatomic, readonly) AVAssetReferenceRestrictions referenceRestrictions
Обсуждение
Для
AVURLAsset
, это свойство отражает, что значение передало в дляAVURLAssetReferenceRestrictionsKey
,если таковые имеются.Значение по умолчанию для этого свойства
AVAssetReferenceRestrictionForbidNone
. ПосмотритеAVURLAssetReferenceRestrictionsKey
для полного обсуждения ссылочных ограничений.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 5.0 и позже.
-
Массив характеристик носителей, для которых опция выбора носителей доступна. (только для чтения)
Объявление
Swift
var availableMediaCharacteristicsWithMediaSelectionOptions: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *availableMediaCharacteristicsWithMediaSelectionOptions
Обсуждение
Значение этого свойства является массивом
NSString
объекты, каждая строка, указывающая характеристику носителей, для которой опция выбора носителей доступна.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 5.0 и позже.
-
Возвраты
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
Доступность
Доступный в iOS 5.0 и позже.
-
compatibleWithSavedPhotosAlbum
СвойствоБулево значение, указывающее, может ли актив быть записан в Сохраненный фото альбом. (только для чтения)
Объявление
Swift
var compatibleWithSavedPhotosAlbum: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isCompatibleWithSavedPhotosAlbum) BOOL compatibleWithSavedPhotosAlbum
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 5.0 и позже.
-
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
Доступность
Доступный в iOS 5.0 и позже.