Photos Framework 新照片框架

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。

u010576399

發佈了46 篇原創文章 · 獲贊 5 · 訪問量 6萬+

私信關注

Photos Framework 新照片框架

1.關鍵詞

2.從相冊選擇圖片 Asset 或視頻 Asset

3.將圖片 Asset 或視頻 Asset 轉換爲真正的文件

4.圖片或視頻文件上傳 CDN

5.下載圖片和視頻保存到手機相冊

6.最後

iOS 異步圖片加載優化與常用開源庫分析

NSAttributedString的用法詳解

Object-C 中的重要類型

[譯] 照片框架

Bonjour 簡介及使用

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結