1.AVAsset 資源
AV Foundation最重要的類就是AVAsset，也是AV Foundation設計的核心。AVAsset是一個抽象類和不可變類，定義了媒體資源混合呈現的方式，將媒體資源的靜態屬性模塊化成一個整體，比如它們的標題，時長和元數據等。
AVAsset提供了對基本媒體格式的層抽象,這意味著無論是處理QuickTime影片,MPEG-4視頻還是MP3音頻,對你和對框架其余部分而言,面對的只要資源的概念.不需要考慮多種編解碼器和容器格式因為細節不同而帶來的困擾.
AVAsset本身不是媒體資源,但是它可以作為時基媒體的容器.它由一個或多個帶有描述自身元數據的媒體組成.我們使用AVAssetTrack類代表保存在資源中的統一類型媒體,并對每個資源建立相應的模型.AVAssetTrack最常見的形態就是音頻和視頻流,但是它還可以用于表示諸如文本,副標題或隱藏字幕等媒體類型.
- AVAsset屬性和方法的簡單介紹
//視頻時長
@property (nonatomic, readonly) CMTime duration;
//默認的速度
@property (nonatomic, readonly) float preferredRate;
//默認音量
@property (nonatomic, readonly) float preferredVolume;
//commonMetadata屬性中包含著當前視頻常見格式類型的元數據
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *commonMetadata;
//metadata屬性中包含當前視頻所有格式類型的元數據
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *metadata;
//availableMetadataFormats屬性中包含當前視頻所有可用元數據的格式類型元數據的格式類型在AVMetadataFormat中定義了很多種，常見的有title、creator、subject、publisher等
@property (nonatomic, readonly) NSArray<NSString *> *availableMetadataFormats;
//此資源中包含的所有曲目(AVAssetTrack),AVAsset還可以通過標識符,媒體類型或媒體特征等信息找到相應的曲目.
@property (nonatomic, readonly) NSArray*tracks;
//通過trackID獲得trackAVAssetTrack
-(nullable AVAssetTrack *)trackWithTrackID:(CMPersistentTrackID)trackID;
//通過指定的媒體類型返回一個AVAssetTrack數組，數組中包含著Asset中所有指定媒體類型的AVAssetTrack。如果Asset中沒有這個媒體類型的AVAssetTrack，返回一個空數組
-(NSArray<AVAssetTrack *> *)tracksWithMediaType:(NSString *)mediaType;
//通過指定的媒體特征返回AVAssetTrack數組，數組的特性與-tracksWithMediaType:類似，如果Asset中沒有這個媒體特征的AVAssetTrack，返回一個空數組。
-(NSArray<AVAssetTrack *> *)tracksWithMediaCharacteristic:(NSString *)mediaCharacteristic;
2.創建資源實例
當你為一個現有媒體資源創建AVAsset對象時,可以通過URL對它進行初始化來實現.URL可以是本地資源的,也可以是遠程資源的.
NSURL *asstUrl=[[NSBundle mainBundle]URLForResource:@"Hubblecast" withExtension:@"mov"];
AVAsset *asset=[AVAsset assetWithURL:asstUrl];
AVAsset是一個抽象類,意味著它不可以被直接實例化,當使用它的assetWithURL:方法創建實例時,實際上是創建其子類(AVURLAsset)的實例.
如果創建一個用在音頻或者視頻編輯場景中的資源,可能希望傳遞一個選項(option)來告訴程序提供更精確的時長和計時信息,傳遞選項就暗示了開發者希望得到稍長一點的加載時間,以獲取更精確的時長和計時信息.
NSURL *asstUrl=[[NSBundle mainBundle]URLForResource:@"Hubblecast" withExtension:@"mov"];
NSDictionary *option=@{AVURLAssetPreferPreciseDurationAndTimingKey:@YES};
AVURLAsset *urlAsset=[[AVURLAsset alloc]initWithURL:asstUrl options:option];
3.異步載入(異步加載)
AVAsset具有多種方法和屬性,可以提供有關資源的信息,比如時長,創建日期和元數據等.
AVAsset還包含一些用于獲取和使用曲目集合的方法.
AVAsset使用一種高效的設計方法,即延遲載入資源的屬性,直到請求時才載入.
AVAsset和AVAssetTrack都采了AVAsynchronousKeyValueLoading協議,該協議通過以下方法實現異步查詢屬性的功能.
//異步載入一個或多個資源的屬性名,當資源處于回應請求時調用block塊.
-(void)loadValuesAsynchronouslyForKeys:(NSArray<NSString *> *)keys completionHandler:(nullable void (^)(void))handler NS_AVAILABLE(10_7, 4_2);
//查詢一個給定屬性的狀態,該方法返回一個枚舉類型的AVKeyValueStatus值,用于表示當前所請求的屬性的狀態.
-(AVKeyValueStatus)statusOfValueForKey:(NSString *)key error:(NSError * __nullable * __nullable)outError NS_AVAILABLE(10_7, 4_2);
- 示例代碼:
NSURL *asstUrl=[[NSBundle mainBundle]URLForResource:@"Hubblecast" withExtension:@"mov"];
AVAsset *asset=[AVAsset assetWithURL:asstUrl];
NSArray *keys=@[@"availableMetadataFormats"];
[asset loadValuesAsynchronouslyForKeys:keys completionHandler:^{
NSError *error=nil;
AVKeyValueStatus state=[asset statusOfValueForKey:@"availableMetadataFormats" error:&error];
switch (state) {
case AVKeyValueStatusLoaded:
NSLog(@"%@",@"加載成功");
break;
case AVKeyValueStatusFailed:
NSLog(@"%@",@"加載失敗");
break;
default:
break;
}
}];
- 注意
- 每次調用loadValuesAsynchronouslyForKeys: completionHandler:方法是只會調用一次completionHandler塊,調用該方法的次數并不是根據傳遞給這個方法的鍵的個數而定的.
- 需要為每個請求的屬性調用tatusOfValueForKey:error:方法,不能假設所有的屬性都返回相同的狀態值.
4.媒體元數據
- AVAsset和AVAssetTrack都可以實現查詢相關元數據的功能,一般情況下使用AVAsset提供的元數據,不過當涉及獲取曲目一級元數據等情況時也會使用AVAssetTrack.
- 讀取具體資源元數據的接口由名為AVMetadataItem的類提供.
AVMetadataItem類提供了一個面向對象的接口,讓我們可以對存儲于QuickTime,MPEG-4 atom和ID3幀中的元數據進行訪問. - AVAsset和AVAssetTrack提供了兩種方法可以獲取相關的元數據.
要了解這兩種方法的適用范圍,首先要知道鍵空間(key spaces)的含義. - AVFoundation使用鍵空間作為將相關鍵組合在一起的方法,可以實現對AVMetadataItem實例集合的篩選.每個資源至少包含兩個鍵空間,供從其中獲取數據.
- Common鍵空間用來定義所有支持的媒體類型的鍵,包括諸如曲名,歌手和插圖信息等常見元素.這提供了一種對所有支持的媒體格式進行一定級別的元數據標準化的過程.
- 我們可以通過查詢資源(AVAsset)或曲目(AVAssetTrack)的commonMetadata屬性從Common鍵空間獲取元數據,這個屬性會返回一個包含所有可用元數據的數組.
@property (nonatomic, readonly) NSArray<AVMetadataItem *> *commonMetadata;
- 訪問指定格式的元數據需要在資源或曲目上調用metadataForFormat:方法.這個方法包含一個用于定義元數據格式的NSString對象并返回一個包含所有相關元數據信息的NSArray.
- 元數據格式的NSString對象可以通過查詢資源或曲目的availableMetadataFormats屬性獲得,其返回一個字符串數組,其中定義了該資源中包含的所有元數據格式,我們可以利用這個結果循環訪問所有格式,并為每種格式調用metadataForFormat:方法.
@property (nonatomic, readonly) NSArray<NSString *> *availableMetadataFormats;
-(NSArray<AVMetadataItem *> *)metadataForFormat:(NSString *)format;
5.查找元數據
- 當我們得到一個包含元數據項的數組時,通常希望找到所需的具體元數據值.
可以使用AVMetadataItem類提供的便利方法,來獲取結果集合并對其進行篩選. - 使用metadataItemsFromArray: withKey: keySpace:方法來對集合進行篩選,得出那些匹配鍵和鍵空間標準的對象.這個方法返回值是一個NSArray,但通常只包含單個AVMetadataItem實例.
- 例子
NSArray *meatataArray=[asset metadataForFormat:format];
NSString *keySpace=AVMetadataKeySpaceCommon;
NSString *artisKey=AVMetadataCommonKeyArtwork;
NSArray *artisArray=[AVMetadataItem metadataItemsFromArray:meatataArray withKey:artisKey keySpace:keySpace];
6.使用AVMetadataItem
- AVMetadataItem最基本的形式其實是一個封裝鍵值對的封裝器.
- 可通過它查詢key或commonKey,查詢其是否存在于Common鍵空間中,最重要的是它對應的value.
- value屬性被定義成id<NSObject,NSCopying>形式,不過它可能是NSString,NSNumber,NSData或者NSDictionary等.
- 代碼
NSURL *asstUrl=[[NSBundle mainBundle]URLForResource:@"Hubblecast" withExtension:@"mov"];
AVAsset *asset=[AVAsset assetWithURL:asstUrl];
NSArray *keys=@[@"availableMetadataFormats"];
[asset loadValuesAsynchronouslyForKeys:keys completionHandler:^{
NSError *error=nil;
AVKeyValueStatus state=[asset statusOfValueForKey:@"availableMetadataFormats" error:&error];
switch (state) {
case AVKeyValueStatusLoaded:
for (NSString *format in asset.availableMetadataFormats)
{
NSArray *meatataArray=[asset metadataForFormat:format];
NSString *keySpace=AVMetadataKeySpaceCommon;
NSString *artisKey=AVMetadataCommonKeyArtwork;
NSArray *artisArray=[AVMetadataItem metadataItemsFromArray:meatataArray withKey:artisKey keySpace:keySpace];
for (AVMetadataItem *item in meatataArray)
{
dispatch_async(dispatch_get_main_queue(), ^{
self.imageView.image=[UIImage imageWithData:item.dataValue];
});
}
}
NSLog(@"%@",@"加載成功");
break;
case AVKeyValueStatusFailed:
NSLog(@"%@",@"加載失敗");
break;
default:
break;
}
}];
7.保存修改之后的元數據
- AVAsset是一個不可變類,我們不能直接修改它.而是使用名為AVAssetExportSession的類導出一個新的資源副本以及元數據改動.
- 應用AVAssetExportSession
- AVAssetExportSession用于將AVAsset內容根據導出預設條件進行轉碼,并將導出資源寫到磁盤中.
- AVAssetExportSession提供了多個功能來實現將一種格式轉換為另一種格式,修訂資源的內容,修改資源的音頻和視頻行為,還有寫入新的元數據.
- 創建一個AVAssetExportSession實例需要提供資源和導出預設.導出預設用于確定導出內容的質量,大小等屬性.創建一個導出會話后,并且需要指定一個outputURL用于聲明導出內容將要寫入的地址.并且要給出一個outputFileType值來表示將要寫入的導出格式.最后調用exportAsynchronouslyWithCompletionHandler:方法開始導出過程.
- 代碼
//AVAssetExportPresetPassthrough預設值,可以讓我們在不需要重新對媒體編碼的前提下實現寫入數據的功能.
NSString *presetName = AVAssetExportPresetPassthrough;
AVAssetExportSession *session =
[[AVAssetExportSession alloc] initWithAsset:self.asset
presetName:presetName];
NSURL *outputURL = [self tempURL];
session.outputURL = outputURL;//寫入磁盤(導出)的URL
session.outputFileType = self.filetype;//導出格式
session.metadata = [self.metadata metadataItems];//需要導出的元數據
[session exportAsynchronouslyWithCompletionHandler:^{
//判斷導出狀態
AVAssetExportSessionStatus status = session.status;
BOOL success = (status == AVAssetExportSessionStatusCompleted);
if (success) {
NSURL *sourceURL = self.url;
NSFileManager *manager = [NSFileManager defaultManager];
[manager removeItemAtURL:sourceURL error:nil];
[manager moveItemAtURL:outputURL toURL:sourceURL error:nil];
}
}];
-(NSURL *)tempURL {
NSString *tempDir = NSTemporaryDirectory();
NSString *ext = [[self.url lastPathComponent] pathExtension];
NSString *tempName = [NSString stringWithFormat:@"temp.%@", ext];
NSString *tempPath = [tempDir stringByAppendingPathComponent:tempName];
return [NSURL fileURLWithPath:tempPath];
}
8.備用媒體AVMediaSelectionOption,AVMediaSelectionGroup
- AVMediaSelectionOption表示AVAsset中的備用媒體呈現方式.一個資源可能包含備用媒體呈現方式,比如備用音頻,視頻或文本軌道.這些軌道可能是指定語言的音頻軌道,備用相機角度或指定語言的字幕.
//表示此資源中有哪些備用軌道,返回一個字符串數組,這些字符串表示保存在資源中可用選項的媒體特征.
//具體來說,返回數組包含的字符串值為AVMediaCharacteristicVisual(視頻),AVMediaCharacteristicAudible(音頻),AVMediaCharacteristicLegible(字幕或隱藏式字幕)
@property (nonatomic, readonly) NSArray<NSString *> *availableMediaCharacteristicsWithMediaSelectionOptions
- 請求可用媒體特征數據后,調用AVAsset的mediaSelectionGroupForMediaCharacteristic:方法,為其傳遞要檢索的選項的特定媒體特征,這個方法返回一個AVMediaSelectionGroup,它作為一個或多個互斥的AVMediaSelectionOption實例的容器;
(方法通過傳入一個媒體特征類型，返回可供選擇的媒體選項集合。例如傳入字幕的媒體特征類型，返回當前Asset的可供選擇的字幕選項集合。)
-(nullable AVMediaSelectionGroup *)mediaSelectionGroupForMediaCharacteristic:(NSString *)mediaCharacteristic
- 簡單示例1
NSArray *mediaCharacteristics=asset.availableMediaCharacteristicsWithMediaSelectionOptions;
for (NSString * Characteristic in mediaCharacteristics) {
AVMediaSelectionGroup *group=[asset mediaSelectionGroupForMediaCharacteristic:Characteristic];
for (AVMediaSelectionOption *option in group.options) {
NSLog(@"option:%@",option.displayName);
}
}
- 簡單示例2
AVMediaSelectionGroup *group=[asset mediaSelectionGroupForMediaCharacteristic:Characteristic];
NSLocale *russianLocal=[[NSLocale alloc]initWithLocaleIdentifier:@"ru_RU"];
NSArray *options=[AVMediaSelectionGroup mediaSelectionOptionsFromArray:group.options withLocale:russianLocal];
AVMediaSelectionOption *option=[options firstObject];
- Asset中默認的媒體選項
//preferredMediaSelection屬性是AVMediaSelection類型，他的作用是主要是為各個媒體選項集合提供默認選項
@property (nonatomic, readonly) AVMediaSelection *preferredMediaSelection
- 代碼
for (NSString *characteristic in asset.availableMediaCharacteristicsWithMediaSelectionOptions) {
AVMediaSelectionGroup *group = [asset mediaSelectionGroupForMediaCharacteristic:characteristic];
AVMediaSelectionOption *option = [asset.preferredMediaSelection selectedMediaOptionInMediaSelectionGroup:group];
NSLog(@"對應媒體特征%@的默認媒體選項是%@",characteristic,option);
}
