[AVFoundation Guide]使用Assets

本文是本人自己辛苦翻译的，请转载的朋友注明，翻译于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和文件格式，和选项其他设置。例如元数据和是否网络优先使用。

图 1-1 输出会话工作流

你可以检测你是否可以导出指定的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来取消输出。

当你尝试覆盖一个存在文件或者把文件写入这个应用外的沙河时候，这个输出将会失败。
以下也有可能导致失败：

• 一个电话打入
• 应用在后台，或者其他应用开始工作。

在这些情况下，你应该通常通知用户导出失败，并允许用户重新导出。