一、不可变对象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;