AVFoundation – AVAsset 加载媒体-猿说编程

ChatGPT 3.5 国内中文镜像站免费使用啦

零基础 Object-C 学习路线推荐 : Object-C 学习目录 >> Object-C 基础
零基础 Object-C 学习路线推荐 : Object-C 学习目录 >> Object-C 线程
零基础 Object-C 学习路线推荐 : Object-C 学习目录 >> OpenGL ES
零基础 Object-C 学习路线推荐 : Object-C 学习目录 >> GPUImage
零基础 Object-C 学习路线推荐 : Object-C 学习目录 >> AVFoundation
零基础 Object-C 学习路线推荐 : Object-C 学习目录 >> CocoaPods

一.前言

1.AVAsset

Assets 可以来自一个文件或用户的相册,可以理解为多媒体资源，通过 URL 作为一个 asset 对象的标识. 这个 URL 可以是本地文件路径或网络流；

2.AVAssetTrack

AVAsset 包含很多轨道 AVAssetTrack 的结合,如 audio, video, text, closed captions, subtitles…

3.AVComposition / AVMutableComposition

使用 AVMutableComposition 类可以增删 AVAsset 来将单个或者多个 AVAsset 集合到一起，用来合成新视频。除此之外，若想将集合到一起的视听资源以自定义的方式进行播放，需要使用 AVMutableAudioMix 和 AVMutableVideoComposition 类对其中的资源进行协调管理；

4.AVMutableVideoComposition

AVFoundation 类 API 中最核心的类是 AVVideoComposition / AVMutableVideoComposition 。

AVVideoComposition / AVMutableVideoComposition 对两个或多个视频轨道组合在一起的方法给出了一个总体描述。它由一组时间范围和描述组合行为的介绍内容组成。这些信息出现在组合资源内的任意时间点。

AVVideoComposition / AVMutableVideoComposition 管理所有视频轨道，可以决定最终视频的尺寸，裁剪需要在这里进行；

5.AVMutableCompositionTrack

将多个 AVAsset 集合到一起合成新视频中轨道信息，有音频轨、视频轨等，里面可以插入各种对应的素材（画中画，水印等）；

6.AVMutableVideoCompositionLayerInstruction

AVMutableVideoCompositionLayerInstruction 主要用于对视频轨道中的一个视频处理缩放、模糊、裁剪、旋转等；

7.AVMutableVideoCompositionInstruction

表示一个指令，决定一个 timeRange 内每个轨道的状态，每一个指令包含多个 AVMutableVideoCompositionLayerInstruction ；而 AVVideoComposition 由多个 AVVideoCompositionInstruction 构成；

AVVideoCompositionInstruction 所提供的最关键的一段数据是组合对象时间轴内的时间范围信息。这一时间范围是在某一组合形式出现时的时间范围。要执行的组全特质是通过其 AVMutableVideoCompositionLayerInstruction 集合定义的。

8.AVAssetExportSession

AVAssetExportSession 主要用于导出视频；

二.AVAsset简介

AVAsset 是 AVFoundation 框架中的核心的类,它提供了基于时间的音视频数据.(如电影文件,视频流),一个 asset 包含很多轨道的结合,如 audio , video , text , closed captions, subtitles …
AVMetadataItem 提供了一个 asset 相关的所有资源信息.
AVAssetTrack 一个轨道可以代表一个音频轨道或视频轨道

三.创建AVAsset

Assets 可以来自一个文件或用户的相册,可以理解为多媒体资源，通过 URL 作为一个 asset 对象的标识. 这个 URL 可以是本地文件路径或网络流

NSURL *url = <#A URL that identifies an audiovisual asset such as a movie file#>;
AVURLAsset *anAsset = [[AVURLAsset alloc] initWithURL:url options:nil];

注意 NSURL 的使用：

[NSURL URLWithString:@"网络路径"]
[NSURL fileURLWithPath:@"本地路径"]
如果读取的是本地文件,那么请用第二个方法,第一个会出错,读取不到URL.

示例：

/******************************************************************************************/
//@Author:猿说编程
//@Blog(个人博客地址): www.codersrc.com
//@File:C语言教程 - AVAsset 加载媒体
//@Time:2021/07/25 07:30
//@Motto:不积跬步无以至千里，不积小流无以成江海，程序人生的精彩需要坚持不懈地积累！
/******************************************************************************************/ 

//获取url
NSURL* url = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"123.mp4" ofType:nil]];

//加载媒体方案一   
AVURLAsset* asset = [[AVURLAsset alloc] initWithURL:url options:nil];
//加载媒体方案二  
AVURLAsset *asset2 = [AVURLAsset assetWithURL:url];
   
NSLog(@"asset:%@  time:%f",asset,CMTimeGetSeconds(asset.duration));
/*
asset:<AVURLAsset: 0x600001f640c0, URL = file:///Users/xxx/Library/Developer/CoreSimulator/Devices/CF7390AF-D7D9-4CDA-8049-167662FFAEAD/data/Containers/Bundle/Application/536B4B5E-46A7-4D53-91B4-1C09A0A72764/LearnAVFoundation.app/123.mp4>  
time:4249.883000
*/

AVAsset:主要用于获取多媒体信息,是一个抽象类,不能直接使用。 AVURLAsset:AVAsset的子类,可以根据一个URL路径创建一个包含媒体信息的AVURLAsset对象；

四.异步加载AVAsset

初始化 asset 并意味着你检索的信息可以马上使用. 它可能需要一定时间去计算视频的信息.因此我们需要使用 block 异步接受处理的结果.使用 AVAsynchronousKeyValueLoading 协议.示例代码如下：

/******************************************************************************************/
//@Author:猿说编程
//@Blog(个人博客地址): www.codersrc.com
//@File:C语言教程 - AVAsset 加载媒体
//@Time:2021/07/25 07:30
//@Motto:不积跬步无以至千里，不积小流无以成江海，程序人生的精彩需要坚持不懈地积累！
/******************************************************************************************/ 


NSURL* url = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"123.mp4" ofType:nil]];
    
AVURLAsset* asset = [[AVURLAsset alloc] initWithURL:url options:nil];
    
NSLog(@"time:%f",CMTimeGetSeconds(asset.duration));
NSArray *keys = @[@"duration"];
     
//异步加载
[asset loadValuesAsynchronouslyForKeys:keys completionHandler:^() {
     
    NSError *error = nil;
    AVKeyValueStatus tracksStatus = [asset statusOfValueForKey:@"duration" error:&error];
    switch (tracksStatus) {
        case AVKeyValueStatusUnknown:
            NSLog(@"AVKeyValueStatusUnknown");
            break;
        case AVKeyValueStatusLoading: //正在加载
            NSLog(@"AVKeyValueStatusLoading");
            break;
        case AVKeyValueStatusLoaded:  //加载完成
            NSLog(@"AVKeyValueStatusLoaded");
            break;
        case AVKeyValueStatusFailed:  //加载失败
            NSLog(@"AVKeyValueStatusFailed");
            break;
        case AVKeyValueStatusCancelled: //取消加载
            NSLog(@"AVKeyValueStatusCancelled");
            break;  
   }
}];

五.AVAsset常用属性

/*播放速率，一般为1；*/
@property (nonatomic, readonly) float preferredRate;

/*播放的优选音量，一般为1;*/
@property (nonatomic, readonly) float preferredVolume;

/*用于呈现或处理asset可视内容的首选转换，一般为单位变换；*/
@property (nonatomic, readonly) CGAffineTransform preferredTransform;

/*一个布尔值，指示资产是否提供精确的时间，NO为不提供，YSE提供。可以在使用URL初始化资产时，设置与时间相关的属性所需的精确度;*/
@property (nonatomic, readonly) BOOL providesPreciseDurationAndTiming;

/*获取接受者使用的控制对外部媒体数据引用的限制;对于AVURLAsset来说，该属性表示AVURLAssetReferenceRestrictionsKey键(如果存在)对应的值。*/
@property (nonatomic, readonly) AVAssetReferenceRestrictions referenceRestrictions； 

//确定asset某些功能的可用性
/*指示AVPlayer是否可以以满足用户期望的方式播放资产的内容（指这一asset或者它的URL是否能用来初始化一个AVPlayerItem的实例）；*/
@property (nonatomic, readonly, getter=isPlayable) BOOL playable;

/*指示asset是否具有受保护的内容。即使媒体资源的playable属性值为YES。包含受保护内容的资产可能无法在未经授权的情况下播放。*/
@property (nonatomic, readonly) BOOL hasProtectedContent;

/*指示asset是否可以使用AVAssetExportSession导出。*/
@property (nonatomic, readonly, getter=isExportable) BOOL exportable;

/*指示是否可以使用AVAssetReader提取asset的媒体数据。*/
@property (nonatomic, readonly, getter=isReadable) BOOL readable;

/*指示是否该asset可以在AVCompositionTrack对象的区段内使用，被用来创建一个AVMutableComposition对象。*/
@property (nonatomic, readonly, getter=isComposable) BOOL composable; 

/*指示是否可以将资源写入“已保存的照片”相册*/
@property (nonatomic, readonly, getter=isCompatibleWithSavedPhotosAlbum) BOOL compatibleWithSavedPhotosAlbum;

/*指示资产是否与AirPlay Video兼容。如果用asset初始化的AVPlayerItem可以通过AirPlay Video由外部设备播放则为YES，反之为NO。*/
@property (nonatomic, readonly, getter=isCompatibleWithAirPlayVideo) BOOL compatibleWithAirPlayVideo;



//访问轨道（tracks）相关 
/*asset包含的所有轨道（AVAssetTrack的实例）的集合;*/
@property (nonatomic, readonly) NSArray<AVAssetTrack *> *tracks;

/*返回具有指定轨道ID的轨道，如果指定trackID的轨道不不存在，则返回nil;*/
- (nullable AVAssetTrack *)trackWithTrackID:(CMPersistentTrackID)trackID;

/*返回呈现指定类型媒体的资产的资产轨道数组;*/
- (NSArray<AVAssetTrack *> *)tracksWithMediaType:(AVMediaType)mediaType;

/*返回呈现具有指定特征的媒体的AVAssetTrack对象的数组;*/
- (NSArray<AVAssetTrack *> *)tracksWithMediaCharacteristic:(AVMediaCharacteristic)mediaCharacteristic;

/*返回asset中所有轨道组（不同的轨道分组）的数组*/
@property (nonatomic, readonly) NSArray<AVAssetTrackGroup *> *trackGroups;




//访问元数据相关
/*获取asset的创建日期，该属性可能为nil，如果创建日期已被asset以可转换为NSDate对象的形式存储，则AVMetadataItem的dateValue属性将提供一个NSDate的实例。否则创建日期只能使用其stringValue值作为字符串值。*/
@property (nonatomic, readonly, nullable) AVMetadataItem *creationDate; 

/*提供对适合当前语言环境的asset的文字歌词的访问;*/
@property (nonatomic, readonly, nullable) NSString *lyrics; 

/*属性中包含着当前视频公共密钥空间中常见格式类型的元数据;*/
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *commonMetadata; 

/*属性中包含当前视频所有格式类型的元数据;*/
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *metadata

/*一组字符串，每个字符串都代表资产可用的元数据格式;*/
@property (nonatomic, readonly) NSArray<AVMetadataFormat> *availableMetadataFormats;

/*根据元数据格式返回AVMetadataItem对象数组。*/
- (NSArray<AVMetadataItem *> *)metadataForFormat:(AVMetadataFormat)format;