OC之合成资源AVComposition

一、不可变对象AVComposition

AVComposition 继承自AVAsset,将来自多个基于源文件的媒体数据组合在一起显示,或处理来自多个源媒体数据。

在其顶层,AVComposition是轨道的集合,每个轨道根据时间表呈现特定媒体类型的媒体:例如音频或视频。每个轨道由AVCompositionTrack的实例表示。每个轨道由一系列轨道片段组成,由AVCompositionTrackSegment实例表示。每个片段存储由URL、轨道标识符和时间映射指定的源容器中的一部分媒体数据。 URL指定源容器,轨道标识符指示要呈现的源容器的轨道。无论容器类型如何,所有基于文件的视听Asset都可以组合在一起。

时间映射指定要呈现的源轨道的时间范围,并且还指定其在合成轨道中的呈现的时间范围。如果时间映射的源和目标范围的时长相同,则片段的媒体数据将以其自然速率呈现。否则,该段将以与 source.duration/target.duration之比相等的速率呈现。

可以使用AVCompositionTracksegments属性访问轨道的轨道片段。具有每个媒体类型信息的轨道集合,以及每个包含其轨道片段数组(URL、音轨标识符和时间映射)的轨道,构成了组合的完整低级表示。这种表示可以由客户端以任何方便的形式写出,随后可以通过使用适当媒体类型的AVMutableCompositionTrack对象实例化新的AVMutableComposition来,每个对象的segment属性根据存储的URL数组、跟踪标识符和时间映射设置,从而重新组合。

AVMutableCompositionAVMutableCompositionTrack也提供了构建组合的高级接口,提供插入、删除和缩放操作,而无需直接操作合成轨道的trackSegment数组。这个接口使用更高级的结构,如AVAssetAVAssetTrack,允许客户端使用与它创建的候选源相同的引用,以便在合成之前检查或预览它们。

只读属性 数据类型 描述
tracks NSArray 组合包含的AVCompositionTrack对象数组。
naturalSize CGSize 组合的视频部分的尺寸
URLAssetInitializationOptions NSDictionary
- (AVCompositionTrack *)trackWithTrackID:(CMPersistentTrackID)trackID;
- (NSArray *)tracksWithMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic;
- (NSArray *)tracksWithMediaType:(AVMediaType)mediaType;

二、可变对象AVMutableComposition

AVMutableComposition 继承自AVComposition,用于从现有Asset创建新合成的可变对象。

该类提供了添加和删除轨道的功能,可以添加、删除和缩放时间范围。可以对一个可变组合做一个不可变的快照,以便回放或检查,如下所示:

//a mutable composition you want to inspect or play in its current state
AVMutableComposition *myMutableComposition = ;

AVComposition *immutableSnapshotOfMyComposition = [myMutableComposition copy]; 

// Create a player to inspect and play the composition.
AVPlayerItem *playerItemForSnapshottedComposition =
[[AVPlayerItem alloc] initWithAsset:immutableSnapshotOfMyComposition];

1、创建一个可变组合

+ (instancetype)compositionWithURLAssetInitializationOptions:(NSDictionary *)URLAssetInitializationOptions;

//返回一个新的,空的,可变的组合。
+ (instancetype)composition;

2、管理时间范围

2.1、插入空白时间范围

在合成轨道上添加空timeRange

- (void)insertEmptyTimeRange:(CMTimeRange)timeRange;

如果在合成轨道上插入空白时间范围,则在插入之前的该时间间隔内显示的任何介质将立即显示。可以使用此方法保留希望随后创建的轨道显示其媒体的间隔。

2.2、插入Asset的给定时间范围

将指定Asset的给定时间范围内的所有轨道插入。

- (BOOL)insertTimeRange:(CMTimeRange)timeRange
ofAsset:(AVAsset *)asset
atTime:(CMTime)startTime
error:(NSError * _Nullable *)outError;
  • 参数timeRange:要插入的Asset的时间范围。
  • 参数asset:要插入的Asset
  • 参数startTime:插入轨道应由接收器呈现的时间。
  • 参数outError:如果插入不成功,则返回NSError
  • 返回值:如果插入成功则为YES,否则为NO。

此方法可以添加新轨道以确保Asset的所有轨道都在插入的时间范围内表示。
插入时间范围的媒体数据以其自然持续时间呈现; 可以使用-scaleTimeRange:toDuration:将其缩放到不同的时长。

2.3、删除指定的timeRange

从合成的所有轨道中删除指定的timeRange

- (void)removeTimeRange:(CMTimeRange)timeRange;

删除后,在timeRange后的现有内容将被推到前面。
删除时间范围不会导致从合成中移除任何现有轨道,即使删除timeRange会导致空轨道;它会删除或截断与时间范围相交的轨道段。

2.4、压缩时长

更改给定时间范围内所有轨道的时长。

- (void)scaleTimeRange:(CMTimeRange)timeRange
toDuration:(CMTime)duration;
  • 参数timeRange:要缩放的合成轨道的时间范围。
  • 参数duration:新的时长。

受缩放操作影响的每个轨道段将以等于其结果时间映射的source.duration/target.duration的速率呈现。

3、管理轨道

//在可变组合中,tracks是AVMutableCompositionTrack的实例,而在AVComposition中,tracks是AVCompositionTrack的实例。
@property(nonatomic, readonly) NSArray *tracks;
3.1、添加空轨道

向接收器添加空轨道。

- (AVMutableCompositionTrack *)addMutableTrackWithMediaType:(AVMediaType)mediaType
preferredTrackID:(CMPersistentTrackID)preferredTrackID;
  • 参数mediaType:轨道的媒体类型。
  • 参数preferredTrackID: 轨道目的首选TrackID。如果不需要指定首选TrackID,传递kCMPersistentTrackID_Invalid。首选TrackID将用于新轨道,前提是它目前尚未使用过。如果指定的首选TrackID不可用,或者传入kCMPersistentTrackID_Invalid,则会生成唯一的TrackID

可以通过“trackID”键获取新轨道的实际trackID

3.2、移除指定的轨道

从接收器移除指定的轨道。

- (void)removeTrack:(AVCompositionTrack *)track;

当它被删除时,track的“composition”键被设置为nil。其他键的值保持不变,供任意使用。

3.3、插入给定AVAssetTrack

返回接收器中可以插入给定AVAssetTrack的任何时间范围的轨道。

- (AVMutableCompositionTrack *)mutableTrackCompatibleWithTrack:(AVAssetTrack *)track;
  • 参数track:可以插入时间范围的AVAssetTrack

为了获得最佳性能,应该保持合成的轨道数量保持在最少,对应于必须并行显示媒体数据的数量。如果要以串行方式呈现相同类型的媒体数据,即使是来自多个资源,也应使用该媒体类型的单个轨道。可以使用此方法为插入标识合适的现有目标轨道。
如果没有可用的兼容轨道,可以使用-addMutableTrackWithMediaType:preferredTrackID:创建与轨道相同的媒体类型的新轨道。
此方法类似于AVAsset-compatibleTrackForCompositionTrack方法。

3.4、其他方法
- (AVMutableCompositionTrack *)trackWithTrackID:(CMPersistentTrackID)trackID;
- (NSArray *)tracksWithMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic;
- (NSArray *)tracksWithMediaType:(AVMediaType)mediaType;

4、配置视频大小

//AVAsset视频部分的尺寸大小;如果未设置此值,则默认行为由AVAsset定义;将值设置为CGSizeZero以还原为默认行为。
@property(nonatomic) CGSize naturalSize;

你可能感兴趣的:(OC之合成资源AVComposition)