OC之合成资源AVComposition
一、不可变对象AVComposition
AVComposition 继承自AVAsset，将来自多个基于源文件的媒体数据组合在一起显示，或处理来自多个源媒体数据。
在其顶层，AVComposition是轨道的集合，每个轨道根据时间表呈现特定媒体类型的媒体：例如音频或视频。每个轨道由AVCompositionTrack的实例表示。每个轨道由一系列轨道片段组成，由AVCompositionTrackSegment实例表示。每个片段存储由URL、轨道标识符和时间映射指定的源容器中的一部分媒体数据。 URL指定源容器，轨道标识符指示要呈现的源容器的轨道。无论容器类型如何，所有基于文件的视听Asset都可以组合在一起。
时间映射指定要呈现的源轨道的时间范围，并且还指定其在合成轨道中的呈现的时间范围。如果时间映射的源和目标范围的时长相同，则片段的媒体数据将以其自然速率呈现。否则，该段将以与 source.duration/target.duration之比相等的速率呈现。
可以使用AVCompositionTrack的segments属性访问轨道的轨道片段。具有每个媒体类型信息的轨道集合，以及每个包含其轨道片段数组(URL、音轨标识符和时间映射)的轨道，构成了组合的完整低级表示。这种表示可以由客户端以任何方便的形式写出，随后可以通过使用适当媒体类型的AVMutableCompositionTrack对象实例化新的AVMutableComposition来，每个对象的segment属性根据存储的URL数组、跟踪标识符和时间映射设置，从而重新组合。
AVMutableComposition和AVMutableCompositionTrack也提供了构建组合的高级接口，提供插入、删除和缩放操作，而无需直接操作合成轨道的trackSegment数组。这个接口使用更高级的结构，如AVAsset和AVAssetTrack，允许客户端使用与它创建的候选源相同的引用，以便在合成之前检查或预览它们。
| 只读属性 | 数据类型 | 描述 |
|---|---|---|
tracks |
NSArray |
组合包含的AVCompositionTrack对象数组。 |
naturalSize |
CGSize |
组合的视频部分的尺寸 |
URLAssetInitializationOptions |
NSDictionary |
- (AVCompositionTrack *)trackWithTrackID:(CMPersistentTrackID)trackID;
- (NSArray<AVCompositionTrack *> *)tracksWithMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic;
- (NSArray<AVCompositionTrack *> *)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<NSString *,id> *)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<AVMutableCompositionTrack *> *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<AVMutableCompositionTrack *> *)tracksWithMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic;
- (NSArray<AVMutableCompositionTrack *> *)tracksWithMediaType:(AVMediaType)mediaType;
4、配置视频大小
//AVAsset视频部分的尺寸大小；如果未设置此值，则默认行为由AVAsset定义;将值设置为CGSizeZero以还原为默认行为。
@property(nonatomic) CGSize naturalSize;
