1. 程式人生 > >ALAsset/PHAsset 中的圖片和視訊檔案

ALAsset/PHAsset 中的圖片和視訊檔案

在微博上出現了越來越多的被標記為 Live 的圖片,這種圖片是一種動圖 LivePhoto,長按之後會進行播放。那麼 LivePhoto 是一種什麼檔案或者格式?其實 LivePhoto 只是一種 iPhone 相簿的資源 Asset,並不是一種特殊的動圖檔案和格式。下面將通過對 PHAsset 的使用過程來描述視訊 Asset,圖片 Asset 和 LivePhoto Asset 與其真正包含檔案的關係。

1.關鍵詞

ALAsset; PHAsset; Photos library; UIImagePickerController; PHLivePhoto; LivePhoto.

ALAsset 或者 PHAsset 代表著由 iPhone 相簿 app 管理的視訊和圖片物件。ALAsset 在 iOS9.0 版本已經被棄用,PHAsset 是 ALAsset 的替代。和手機相簿(Photos)進行的互動,比如選擇圖片上傳,都會涉及到 ALAsset/PHAsset 相關的概念。

//使用 ALAsset 需要引入 AssetsLibrary。 AssetsLibrary 在 iOS9.0 已經過期。
#import <AssetsLibrary/AssetsLibrary.h>
//使用 PHAsset 需要引入Photos Framework,支援 iOS8.0 及以上版本。
#import <Photos/Photos.h> 

ALAsset/PHAsset 並不是真正的檔案物件,他們僅僅包含真正檔案的基本資訊如:檔案路徑,檔案元資料。甚至一個 Asset 會包含多個檔案 (多個 ALAssetRepresentation 或者 PHAssetResource), 如  LivePhoto

 包含一個 jpeg 圖片和一個 mov 視訊兩個檔案。 

LivePhoto 是在 iPhone6s 及更新的裝置上用相機拍攝的一張照片,其特點是包含了照片拍攝時刻之前和之後幾秒鐘的視訊(拍攝 LivePhoto 需要 iPhone6s 及更新的裝置;LivePhoto 的操作和播放只需要安裝了 iOS9.1 及以上系統版本的 iPhone 即可),LivePhoto 不是一種新檔案格式,只是一種特別的 PHAsset。

ALAsset/PHAsset 物件較為複雜,所以理清 ALAsset/PHAsset 和真正檔案的關係,才能使後續的視訊和圖片檔案的操作,比如上傳 CDN,變得好理解。

下面以一個常見的使用場景進行 PHAsset 操作過程的描述:

從相簿選擇圖片或視訊 — 將圖片或視訊上傳 CDN — 下載圖片或視訊 — 將圖片或視訊儲存到相簿

(ALAsset 已在 iOS9.0 過期,所以主要以 PHAsset 做為例子)

2.從相簿選擇圖片 Asset 或視訊 Asset

UIImagePickerController 是從相簿選取圖片 Asset 和視訊 Asset 的選擇器,利用其進行圖片和視訊選擇結束之後會通過其代理(實現了 UIImagePickerControllerDelegate 協議)執行下面的方法, 將選擇結果返回給使用者。

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary<NSString *,id> *)info;

從上面的介面看到,選擇回來的僅僅是 info 資訊,PHAsset 需要利用 info 字典的資訊進一步獲得。info 字典例子:

//選擇的是圖片
info{
    UIImagePickerControllerMediaType = "public.image";
    UIImagePickerControllerOriginalImage = "<UIImage: 0x126cacc60> size {2048, 1365} orientation 0 scale 1.000000";
    UIImagePickerControllerReferenceURL = "assets-library://asset/asset.PNG?i/../B&ext=PNG";
}

//選擇的是視訊
info{
    UIImagePickerControllerMediaType = "public.movie";
    UIImagePickerControllerMediaURL = "file:///private/../BD-E6D273D5B376.MOV";
    UIImagePickerControllerReferenceURL = "assets-library://asset/asset.MOV?id=546/../B&ext=MOV";
}

//選擇的是 LivePhoto
info{
    UIImagePickerControllerLivePhoto = "<PHLivePhoto: 0x126e3a170>";
    UIImagePickerControllerMediaType = "com.apple.live-photo";
    UIImagePickerControllerOriginalImage = "<UIImage: 0x126c56b10> size {960, 1280} orientation 0 scale 1.000000";
    UIImagePickerControllerReferenceURL = "assets-library://asset/asset.JPG?id/../B3&ext=JPG";
}

從 info 字典的例子可以看到,選擇圖片,視訊和 LivePhoto 三種的回撥資訊是有區別的,每個結果包含的欄位也不相同,但是都有個 UIImagePickerControllerReferenceURL 鍵值,顧名思義,assets-library 這條 URL 便是指向我們所選擇的 PHAsset 物件的 URL。

Fetching Assets: 從 assets-library URL 獲取我們需要的圖片和視訊 Asset 

    NSURL *url = [info objectForKey:@"UIImagePickerControllerReferenceURL"];
    PHFetchResult *fetchResult = [PHAsset fetchAssetsWithALAssetURLs:@[url] options:nil];
    PHAsset *asset = fetchResult.firstObject;

Reading Asset Metadata: PHAsset 物件僅僅包含檔案的基本資料  (Assets contain only metadata) 。 

這些基本資訊包含:媒體屬性 (mediaType),資源型別 (sourceType),圖片畫素長寬 (pixelWidth),拍攝地點(location),視訊播放時長 (duration) 等。我們下面的例子用到  mediaType 和  mediaSubtypes 兩個屬性來區分圖片,視訊和 LivePhoto 三種不同的 Asset。 

3.將圖片 Asset 或視訊 Asset 轉換為真正的檔案

經過上面 Fetching Assets 步驟我們已經成功的從 assets-library url 提取出 PHAsset 物件。現在需要把 PHAsset 轉換為真正的視訊和圖片檔案。我們要獲取的真正檔案無非兩種:圖片檔案和視訊檔案。上面示例涉及的三種 PHAsset,其中視訊 Asset 和圖片 Asset 可以分別提取視訊和圖片檔案。LivePhoto Asset 既可以提取圖片也可以提取視訊。

從 PHAsset 獲取圖片:

+ (void)getImageFromPHAsset:(PHAsset *)asset Complete:(Result)result {
    __block NSData *data;
    PHAssetResource *resource = [[PHAssetResource assetResourcesForAsset:asset] firstObject];
    if (asset.mediaType == PHAssetMediaTypeImage) {
        PHImageRequestOptions *options = [[PHImageRequestOptions alloc] init];
        options.version = PHImageRequestOptionsVersionCurrent;
        options.deliveryMode = PHImageRequestOptionsDeliveryModeHighQualityFormat;
        options.synchronous = YES;
        [[PHImageManager defaultManager] requestImageDataForAsset:asset
                                                          options:options
                                                    resultHandler:
         ^(NSData *imageData,
           NSString *dataUTI,
           UIImageOrientation orientation,
           NSDictionary *info) {
             data = [NSData dataWithData:imageData];
         }];
    }
    
    if (result) {
        if (data.length <= 0) {
            result(nil, nil);
        } else {
            result(data, resource.originalFilename);
        }
    }
}

在上面的程式碼中我們通過判斷  asset.mediaType == PHAssetMediaTypeImage 來區分 PHAsset 是否是一個圖片型別的 Asset。值得注意的是 LivePhoto Asset 的 mediaType 屬性值也等於 PHAssetMediaTypeImage,所以提取 LivePhoto 裡面的圖片也可以直接呼叫此方法。 

既然 mediaType 屬性一樣,怎麼才能具體區分一個 PHAsset 是圖片 Asset 還是 LivePhoto 呢,答案是通過 PHAsset 的 mediaSubtypes 屬性。

PHAsset 的媒體屬性 (mediaType)和二級媒體屬性(mediaSubtypes):

typedef NS_ENUM(NSInteger, PHAssetMediaType) {
    PHAssetMediaTypeUnknown = 0,
    PHAssetMediaTypeImage   = 1,
    PHAssetMediaTypeVideo   = 2,
    PHAssetMediaTypeAudio   = 3,
} NS_ENUM_AVAILABLE_IOS(8_0);

typedef NS_OPTIONS(NSUInteger, PHAssetMediaSubtype) {
    PHAssetMediaSubtypeNone               = 0,
    
    // Photo subtypes
    PHAssetMediaSubtypePhotoPanorama      = (1UL << 0),
    PHAssetMediaSubtypePhotoHDR           = (1UL << 1),
    PHAssetMediaSubtypePhotoScreenshot NS_AVAILABLE_IOS(9_0) = (1UL << 2),
    PHAssetMediaSubtypePhotoLive NS_AVAILABLE_IOS(9_1) = (1UL << 3),
    
    // Video subtypes
    PHAssetMediaSubtypeVideoStreamed      = (1UL << 16),
    PHAssetMediaSubtypeVideoHighFrameRate = (1UL << 17),
    PHAssetMediaSubtypeVideoTimelapse     = (1UL << 18),
} NS_AVAILABLE_IOS(8_0);

可以看到 PHAsset mediaType 可以區分圖片,視訊和音訊。PhotoLive 屬於 Photo 型別下面的一個 subtypes。

從 PHAsset 獲取視訊:

+ (void)getVideoFromPHAsset:(PHAsset *)asset Complete:(Result)result {
    NSArray *assetResources = [PHAssetResource assetResourcesForAsset:asset];
    PHAssetResource *resource;

    for (PHAssetResource *assetRes in assetResources) {
        if (assetRes.type == PHAssetResourceTypePairedVideo ||
            assetRes.type == PHAssetResourceTypeVideo) {
            resource = assetRes;
        }
    }
    NSString *fileName = @"tempAssetVideo.mov";
    if (resource.originalFilename) {
        fileName = resource.originalFilename;
    }
    
    if (asset.mediaType == PHAssetMediaTypeVideo || asset.mediaSubtypes == PHAssetMediaSubtypePhotoLive) {
        PHVideoRequestOptions *options = [[PHVideoRequestOptions alloc] init];
        options.version = PHImageRequestOptionsVersionCurrent;
        options.deliveryMode = PHImageRequestOptionsDeliveryModeHighQualityFormat;
        
        NSString *PATH_MOVIE_FILE = [NSTemporaryDirectory() stringByAppendingPathComponent:fileName];
        [[NSFileManager defaultManager] removeItemAtPath:PATH_MOVIE_FILE error:nil];
        [[PHAssetResourceManager defaultManager] writeDataForAssetResource:resource
                                                                    toFile:[NSURL fileURLWithPath:PATH_MOVIE_FILE]
                                                                   options:nil
                                                         completionHandler:^(NSError * _Nullable error) {
                                                             if (error) {
                                                                 result(nil, nil);
                                                             } else {
                                                                 
                                                                 NSData *data = [NSData dataWithContentsOfURL:[NSURL fileURLWithPath:PATH_MOVIE_FILE]];
                                                                 result(data, fileName);
                                                             }
                                                             [[NSFileManager defaultManager] removeItemAtPath:PATH_MOVIE_FILE  error:nil];
                                                         }];
    } else {
        result(nil, nil);
    }
}

注:上面方法兼顧了從 LivePhoto 裡面提取視訊檔案。

4.圖片或視訊檔案上傳 CDN

上面兩段程式碼具體介紹了 PHAsset 到真正圖片檔案和視訊檔案的提取過程。既:可以簡單裡複用這兩個方法來提取真正的 fileData。然後將 fileData 上傳到 CDN 或者伺服器。

typedef void(^Result)(NSData *fileData, NSString *fileName);
+ (void)getImageFromPHAsset:(PHAsset *)asset Complete:(Result)result;
+ (void)getVideoFromPHAsset:(PHAsset *)asset Complete:(Result)result;

值得注意的是:上述兩個介面,最後回撥結果是 fileData。對於圖片 PHAsset,因為圖片檔案不會很大,所以直接拿到圖片 data 是可以的。但是對於視訊 PHAsset,視訊檔案較大會佔用大量記憶體空間。 我們可以通過修改上面的介面,用視訊的 filePath 來替代 fileData,以解決處理大檔案視訊情況下的記憶體佔用問題。

修改介面,獲取 videoFilePath,注意:使用完成,最好手動刪除這個臨時檔案

typedef void(^ResultPath)(NSString *filePath, NSString *fileName);

+ (void)getVideoPathFromPHAsset:(PHAsset *)asset Complete:(ResultPath)result {
    NSArray *assetResources = [PHAssetResource assetResourcesForAsset:asset];
    PHAssetResource *resource;
    
    for (PHAssetResource *assetRes in assetResources) { 
        if (assetRes.type == PHAssetResourceTypePairedVideo ||
            assetRes.type == PHAssetResourceTypeVideo) {
            resource = assetRes;
        }
    }
    NSString *fileName = @"tempAssetVideo.mov";
    if (resource.originalFilename) {
        fileName = resource.originalFilename;
    }
    
    if (asset.mediaType == PHAssetMediaTypeVideo || asset.mediaSubtypes == PHAssetMediaSubtypePhotoLive) {
        PHVideoRequestOptions *options = [[PHVideoRequestOptions alloc] init];
        options.version = PHImageRequestOptionsVersionCurrent;
        options.deliveryMode = PHImageRequestOptionsDeliveryModeHighQualityFormat;
        
        NSString *PATH_MOVIE_FILE = [NSTemporaryDirectory() stringByAppendingPathComponent:fileName];
        [[NSFileManager defaultManager] removeItemAtPath:PATH_MOVIE_FILE error:nil];
        [[PHAssetResourceManager defaultManager] writeDataForAssetResource:resource
                                                                    toFile:[NSURL fileURLWithPath:PATH_MOVIE_FILE]
                                                                   options:nil
                                                         completionHandler:^(NSError * _Nullable error) {
                                                             if (error) {
                                                                 result(nil, nil);
                                                             } else {
                                                                 result(PATH_MOVIE_FILE, fileName);
                                                             }
                                                         }];
    } else {
        result(nil, nil);
    }
}

利用返回的 filePath 可以通過流式的讀取檔案方式,來組織和傳送上傳請求的 body 體,達到較好的記憶體佔用。同時又拍雲 CDN 提供檔案分塊上傳介面,更適合這種大檔案的上傳操作。

5.下載圖片和視訊儲存到手機相簿

將圖片檔案和視訊檔案儲存到手機相簿需要以下兩個方法:

void UIImageWriteToSavedPhotosAlbum(UIImage *image, id completionTarget, SEL completionSelector, void * contextInfo);
void UISaveVideoAtPathToSavedPhotosAlbum(NSString *videoPath, id completionTarget, SEL completionSelector, void * contextInfo);

那麼如何儲存 LivePhoto,對於支援 LivePhoto 的手機使用者可能需要將 LivePhoto 儲存到手機相簿。但是事實上 LivePhoto 不能作為一個整體檔案存在於記憶體硬碟或者伺服器。但是可以將一個視訊檔案和圖片檔案一起作為 LivePhoto Asset 儲存到相簿:

儲存 LivePhoto 程式碼示例:

    NSURL *photoURL = [NSURL fileURLWithPath:photoURLstring];//@"...picture.jpg"
    NSURL *videoURL = [NSURL fileURLWithPath:videoURLstring];//@"...video.mov"
    
    [[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
        PHAssetCreationRequest *request = [PHAssetCreationRequest creationRequestForAsset];
        [request addResourceWithType:PHAssetResourceTypePhoto
                             fileURL:photoURL
                             options:nil];
        [request addResourceWithType:PHAssetResourceTypePairedVideo
                             fileURL:videoURL
                             options:nil];
        
    } completionHandler:^(BOOL success,
                          NSError * _Nullable error) {
        if (success) {
            [self alertMessage:@"LivePhotos 已經儲存至相簿!"];

        } else {
            NSLog(@"error: %@",error);
        }
    }];

6.最後

ALAsset/PHAsset 是屬於 iPhone 相簿相關操作範圍內的概念,ALAsset/PHAsset 並不是檔案,不能直接上傳 CDN。上傳 CDN 需要的真正圖片視訊檔案可以用上文提供的方法從 PHAsset 提取出來。 LivePhoto 屬於一種特殊的 PHAsset,可以從 LivePhoto 裡面分別提取圖片和視訊檔案之後,再上傳 CDN。

轉載自:http://www.tuicool.com/articles/Evma2yI