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<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;
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容