本文是本人自己辛苦翻译的，请转载的朋友注明，翻译于Z.MJun的简书 ，感谢！<翻译不容易啊>
翻译于2016年9月6日
Assets可以从用户的IPod's库或者图片库的一个文件或者媒体来。当你创建一个Assets对象，所有的信息，你想检索的是不可以立即可用的。例如你有一个电影的Assets，你可以提取它的图片，转成其他格式，或者修建内容。
创建一个Assets
创建Assets来代表任何资源，你可以使用一个URL，使用AVURLAsset以下是一个极简单的例子。
NSURL *url = <#A URL that identifies an audiovisual asset such as a movie file#>;
AVURLAsset *anAsset = [[AVURLAsset alloc] initWithURL:url options:nil];
Asset初始化设置
AVURLAsset初始方法的第二参数位选项字典。使用在字典里面的唯一一个关键词为[AVURLAssetPreferPreciseDurationAndTimingKey](https://developer.apple.com/reference/avfoundation/avurlassetpreferprecisedurationandtimingkey)。相对应的值是布尔值（包含一个NSValue`对象）。这表明，Asset是否应该准备好表示一个精确的持续时间和提供精确随机存取时间。
获取Asset的精确时间，可能需要明显的性能开销。但是使用一个相对的持续时间通常可以大大减少开销和足够的回放。
- 如果你只是打算播放Asset，可以使用
nil替换这个字典，或者使用一个字典AVURLAssetPreferPreciseDurationAndTimingKey和值为NO。 - 如果你想增加Asset到组件里面AVMutableComposition，你通常需要精确地随机存取。使用一个字典
AVURLAssetPreferPreciseDurationAndTimingKeykey，和对应值Yes。
NSURL *url = <#A URL that identifies an audiovisual asset such as a movie file#>;
NSDictionary *options = @{ AVURLAssetPreferPreciseDurationAndTimingKey : @YES };
AVURLAsset *anAssetToUseInAComposition = [[AVURLAsset alloc] initWithURL:url options:options];
访问用户的Assets
访问iPod库或者图片应用管理的Assets，你需要获取Assets的URL。
- 访问IPod库，创建MPMediaQuery实例来需找你想要的内容，获取URL使用MPMediaItemPropertyAssetURL
有个更多关于媒体库的，请看Multimedia Programming Guide。 - 访问图片应用，请看ALAssetsLibrary
根据这个例子，你可以获得一个asset来表示存放在相片册里面的第一个视频。
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
// Enumerate just the photos and videos group by using ALAssetsGroupSavedPhotos.
[library enumerateGroupsWithTypes:ALAssetsGroupSavedPhotos usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
// Within the group enumeration block, filter to enumerate just videos.
[group setAssetsFilter:[ALAssetsFilter allVideos]];
// For this example, we're only interested in the first item.
[group enumerateAssetsAtIndexes:[NSIndexSet indexSetWithIndex:0]
options:0
usingBlock:^(ALAsset *alAsset, NSUInteger index, BOOL *innerStop) {
// The end of the enumeration is signaled by asset == nil.
if (alAsset) {
ALAssetRepresentation *representation = [alAsset defaultRepresentation];
NSURL *url = [representation url];
AVAsset *avAsset = [AVURLAsset URLAssetWithURL:url options:nil];
// Do something interesting with the AV asset.
}
}];
}
failureBlock: ^(NSError *error) {
// Typically you should handle an error more gracefully than this.
NSLog(@"No groups");
}];
准备使用Asset
初始化一个Asset（或者轨道）不代表所有的信息你马上能使用。他可能要求一些时间来计算，如总时长（一个MP3文件，例如，可能没有包含所有信息）。而不是阻塞一个当前线程直到这个值倍计算出来，你应该使用AVAsynchronousKeyValueLoading协议来请求这个值，和只用一个block来获取这个数据。AVAsset和AVAssetTrack符合AVAsynchronousKeyValueLoading协议。
测试是有有一个是加载是为一个属性服务statusOfValueForKey:error:。当一个asset第一加载，大多数情况下是AVKeyValueStatusUnknown。位一个或多个属性加载一个值，可以借助loadValuesAsynchronouslyForKeys:completionHandler:。在完成的处理程序中，你采取任何适当的行动都是取决于属性的状态。你应该总是为加载失败准备，因为失败有很多原因，如网络无法访问，或者请求被取消。
NSURL *url = <#A URL that identifies an audiovisual asset such as a movie file#>;
AVURLAsset *anAsset = [[AVURLAsset alloc] initWithURL:url options:nil];
NSArray *keys = @[@"duration"];
[asset loadValuesAsynchronouslyForKeys:keys completionHandler:^() {
NSError *error = nil;
AVKeyValueStatus tracksStatus = [asset statusOfValueForKey:@"duration" error:&error];
switch (tracksStatus) {
case AVKeyValueStatusLoaded:
[self updateUserInterfaceForDuration];
break;
case AVKeyValueStatusFailed:
[self reportError:error forAsset:asset];
break;
case AVKeyValueStatusCancelled:
// Do whatever is appropriate for cancelation.
break;
}
}];
如果你想为回放准备一个asset，你需要请求tracks属性，关于更多的播放中的asset，请看Playback。
从Video获取一个静态图片
从asset获取静态图片，如略缩图，你可以使用 AVAssetImageGenerator对象。使用你的asset初始化图片generator。初始化可能成功，不过，即使asset在初始化的时候没有视觉跟踪，但是，如果有需要可以使用trackswithmediacharacteristic来检测asset任何具有视觉特性的轨道。
AVAsset anAsset = <#Get an asset#>;
if ([[anAsset tracksWithMediaType:AVMediaTypeVideo] count] > 0) {
AVAssetImageGenerator *imageGenerator =
[AVAssetImageGenerator assetImageGeneratorWithAsset:anAsset];
// Implementation continues...
}
你可以配置一些特性是关于图片generator。例如，你可以指定图像的最大尺寸和分别使用maximumSize生成最大光圈模式和apertureMode。你也可以在一个是指定的时间生成单张图片或者一系列图片。你需要保证，图片generator保持强引用，直到所有图片生成。
生成单张图片
你可以使用copyCGImageAtTime:actualTime:error:在特定时间生成单张图片。AVFoundation有可能不能生成你想要的一个精确时间的图片。所以你可以通过第二参数指向CMTime，这个时间包含了你想生成图片的时间，从而达到图片真正的生成了。
AVAsset *myAsset = <#An asset#>];
AVAssetImageGenerator *imageGenerator = [[AVAssetImageGenerator alloc] initWithAsset:myAsset];
Float64 durationSeconds = CMTimeGetSeconds([myAsset duration]);
CMTime midpoint = CMTimeMakeWithSeconds(durationSeconds/2.0, 600);
NSError *error;
CMTime actualTime;
CGImageRef halfWayImage = [imageGenerator copyCGImageAtTime:midpoint actualTime:&actualTime error:&error];
if (halfWayImage != NULL) {
NSString *actualTimeString = (NSString *)CMTimeCopyDescription(NULL, actualTime);
NSString *requestedTimeString = (NSString *)CMTimeCopyDescription(NULL, midpoint);
NSLog(@"Got halfWayImage: Asked for %@, got %@", requestedTimeString, actualTimeString);
// Do something interesting with the image.
CGImageRelease(halfWayImage);
}
生成序列图片
生成一系列图片，你可以发送图片generator一个enerateCGImagesAsynchronouslyForTimes:completionHandler:消息。第一个参数是一个NSValue的数组，每个都包含CMTime结构，指定了你想要的那张图片的时间。第二参数是一个Block，来确定每张图片是否生成。
block包含参数：
- 图片
- 时间，这个时间是你想要生成图片的时间
- 错误提示，描述生成失败的原因
当你执行你的block，检查结果是否生成了图片。另外，你需要保证，图片generator保持强引用，直到所有图片生成。
AVAsset *myAsset = <#An asset#>];
// Assume: @property (strong) AVAssetImageGenerator *imageGenerator;
self.imageGenerator = [AVAssetImageGenerator assetImageGeneratorWithAsset:myAsset];
Float64 durationSeconds = CMTimeGetSeconds([myAsset duration]);
CMTime firstThird = CMTimeMakeWithSeconds(durationSeconds/3.0, 600);
CMTime secondThird = CMTimeMakeWithSeconds(durationSeconds*2.0/3.0, 600);
CMTime end = CMTimeMakeWithSeconds(durationSeconds, 600);
NSArray *times = @[NSValue valueWithCMTime:kCMTimeZero],
[NSValue valueWithCMTime:firstThird], [NSValue valueWithCMTime:secondThird],
[NSValue valueWithCMTime:end]];
[imageGenerator generateCGImagesAsynchronouslyForTimes:times
completionHandler:^(CMTime requestedTime, CGImageRef image, CMTime actualTime, AVAssetImageGeneratorResult result, NSError *error) {
NSString *requestedTimeString = (NSString *)
CFBridgingRelease(CMTimeCopyDescription(NULL, requestedTime));
NSString *actualTimeString = (NSString *)
CFBridgingRelease(CMTimeCopyDescription(NULL, actualTime));
NSLog(@"Requested: %@; actual %@", requestedTimeString, actualTimeString);
if (result == AVAssetImageGeneratorSucceeded) {
// Do something interesting with the image.
}
if (result == AVAssetImageGeneratorFailed) {
NSLog(@"Failed with error: %@", [error localizedDescription]);
}
if (result == AVAssetImageGeneratorCancelled) {
NSLog(@"Canceled");
}
}];
你可以使用cancelAllCGImageGeneration取消图片generator。
电影微调和转码
你可以使用AVAssetExportSession把电影从这个格式转换到另一个格式，和微调电影。工作流如下图。一个输出会话是一个控制器队形管理异步的Asset输出。初始化会话使用你想导出的Asset，和一个输出设定名称，表明你想申请的输出选项。（看allExportPresets）。你可以配置输出会话来制定输出的URL和文件格式，和选项其他设置。例如元数据和是否网络优先使用。
你可以检测你是否可以导出指定的asset。使用 exportPresetsCompatibleWithAsset:。如一下例子说明
AVAsset *anAsset = <#Get an asset#>;
NSArray *compatiblePresets = [AVAssetExportSession exportPresetsCompatibleWithAsset:anAsset];
if ([compatiblePresets containsObject:AVAssetExportPresetLowQuality]) {
AVAssetExportSession *exportSession = [[AVAssetExportSession alloc]
initWithAsset:anAsset presetName:AVAssetExportPresetLowQuality];
// Implementation continues.
}
你根据给定的输出URL完成了会话配置（URL必须是文件URL）AVAssetExportSession通常可以推断输出文件类型来自URL的路径扩展。但是，你可以直接设置outputFileType。你也可以指定额外属性，如时间区间，最小输出文件长度。输出的文件是否应该网络有限使用，和视频组件。根据这个例子说明，怎么使用timeRange这个属性来微调电影。
exportSession.outputURL = <#A file URL#>;
exportSession.outputFileType = AVFileTypeQuickTimeMovie;
CMTime start = CMTimeMakeWithSeconds(1.0, 600);
CMTime duration = CMTimeMakeWithSeconds(3.0, 600);
CMTimeRange range = CMTimeRangeMake(start, duration);
exportSession.timeRange = range;
创建一个新的文件，你可以借助exportAsynchronouslyWithCompletionHandler:这个方法。当操作完成会相应完成Block。在你实现的处理程序，你应该检查会话的状态值，决定了这个输出是否成功，失败，或者取消。
[exportSession exportAsynchronouslyWithCompletionHandler:^{
switch ([exportSession status]) {
case AVAssetExportSessionStatusFailed:
NSLog(@"Export failed: %@", [[exportSession error] localizedDescription]);
break;
case AVAssetExportSessionStatusCancelled:
NSLog(@"Export canceled");
break;
default:
break;
}
}];
你可以通过对会话发送cancelExport来取消输出。
当你尝试覆盖一个存在文件或者把文件写入这个应用外的沙河时候，这个输出将会失败。
以下也有可能导致失败：
- 一个电话打入
- 应用在后台，或者其他应用开始工作。
在这些情况下，你应该通常通知用户导出失败，并允许用户重新导出。
