您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 儲存照片到系統相冊與自建相簿的完整做法

編輯:iOS 開發綜合

「儲存到相簿」幾乎是每個社交類 App 的標配功能。聽起來簡單,但實作時會遇到幾個關卡:怎麼存、怎麼知道存成功了、使用者關閉權限時該怎麼辦、能不能存到自己的相簿裡。本文依序處理這四件事。

一、儲存到系統相冊

1. 用 UIImageView 把照片顯示出來

我們要保存的是 UIImage,所以先準備一張圖並展示:

#define SCREEN [UIScreen mainScreen].bounds.size

self.image = [UIImage imageNamed:@"iOSDevTip"];
UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake((SCREEN.width - 300) / 2, 70, 300, 150)];
imageView.image = self.image;
[self.view addSubview:imageView];

2. 建立一顆按鈕

UIButton *button = [[UIButton alloc] init];
button.frame = CGRectMake(100, 300, SCREEN.width - 200, 40);
[button addTarget:self action:@selector(actionClick:) forControlEvents:UIControlEventTouchUpInside];
[button setTitleColor:[UIColor blueColor] forState:UIControlStateNormal];
[button setBackgroundColor:[UIColor orangeColor]];
[button setTitle:@"SavePhoto" forState:UIControlStateNormal];
[self.view addSubview:button];

- (void)actionClick:(UIButton *)button {
    // 在這裡觸發儲存
}

3. 呼叫系統 API 完成儲存

UIImageWriteToSavedPhotosAlbum(self.image, self, @selector(image:didFinishSavingWithError:contextInfo:), NULL);

這個函式是非同步的,成功或失敗都會透過你指定的回呼方法回報:

// 指定回呼方法
- (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo {
    if (!error) {
        NSLog(@"儲存成功");
    } else {
        NSLog(@"儲存失敗");
    }
}

方法簽名必須與此完全一致,拼錯或參數有異都不會被呼叫——這是新手最常卡住的地方。

二、儲存到自己建立的相簿

系統相冊往往被使用者塞滿幾千張照片,把 App 的產出歸到自己專屬的相簿裡,對使用者友善得多。以下使用 ALAssetsLibrary 來實作。

1. 建立相簿

ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library addAssetsGroupAlbumWithName:@"test" resultBlock:^(ALAssetsGroup *group) {
    // 建立相簿成功
} failureBlock:^(NSError *error) {
    // 失敗
}];

2. 儲存照片(寫入系統相冊)

注意這個方法寫入的是系統相冊,不是自建相簿:

ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library writeImageToSavedPhotosAlbum:image.CGImage orientation:(ALAssetOrientation)image.imageOrientation completionBlock:^(NSURL *assetURL, NSError *error) {
    if (error) {
        // 失敗
    } else {
        UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"儲存成功" message:nil delegate:nil cancelButtonTitle:@"確定" otherButtonTitles:nil, nil];
        [alert show];
    }
}];

3. 權限處理:別讓失敗靜默發生

如果使用者在設定裡關掉了相冊權限,儲存必然失敗。若你不做任何處理,使用者只會覺得「這 App 壞了」,不會知道是權限問題。因此務必在失敗時給出明確指引。

取得權限狀態有兩個自然時機:建立相簿失敗與儲存照片失敗。以建立相簿為例:

ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library addAssetsGroupAlbumWithName:@"test" resultBlock:^(ALAssetsGroup *group) {
    // 建立相簿成功
} failureBlock:^(NSError *error) {
    UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"儲存失敗"
                                                   message:@"請開啟 設定 - 隱私 - 照片 進行設定"
                                                  delegate:nil
                                         cancelButtonTitle:@"確定"
                                         otherButtonTitles:nil, nil];
    [alert show];
}];

更進一步的做法是主動跳到系統設定頁,讓使用者不必自己找路徑,轉換率會明顯提高。

4. 完整的「存到自建相簿」流程

下面這段把整個流程串起來:先確認相簿存在(不存在就建立),再把圖片寫入系統相冊,接著取得該資產並加入自建相簿。這段程式碼在網路上流傳甚廣,實測可用:

#pragma mark - 建立相冊
- (void)createAlbum {
    ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
    NSMutableArray *groups = [[NSMutableArray alloc] init];

    ALAssetsLibraryGroupsEnumerationResultsBlock listGroupBlock = ^(ALAssetsGroup *group, BOOL *stop) {
        if (group) {
            [groups addObject:group];
        } else {
            BOOL haveAlbum = NO;
            for (ALAssetsGroup *gp in groups) {
                NSString *name = [gp valueForProperty:ALAssetsGroupPropertyName];
                if ([name isEqualToString:@"iOSDevTip"]) {
                    haveAlbum = YES;
                }
            }
            if (!haveAlbum) {
                [assetsLibrary addAssetsGroupAlbumWithName:@"iOSDevTip"
                                              resultBlock:^(ALAssetsGroup *group) {
                    [groups addObject:group];
                } failureBlock:nil];
            }
        }
    };

    [assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAlbum usingBlock:listGroupBlock failureBlock:nil];

    [self saveToAlbumWithMetadata:nil
                        imageData:UIImagePNGRepresentation(self.image)
                  customAlbumName:@"iOSDevTip"
                  completionBlock:^{
                      // 加入成功
                  }
                     failureBlock:^(NSError *error) {
        // 回到主線程彈出提示,否則在背景佇列上 alert 不會顯示
        dispatch_async(dispatch_get_main_queue(), ^{
            // 加入失敗多半是使用者拒絕權限,這裡針對這種情況判斷
            NSString *desc = error.localizedDescription;
            if ([desc rangeOfString:@"User denied access"].location != NSNotFound
                || [desc rangeOfString:@"用戶拒絕訪問"].location != NSNotFound) {
                UIAlertView *alert = [[UIAlertView alloc] initWithTitle:desc
                                                              message:error.localizedFailureReason
                                                             delegate:nil
                                                    cancelButtonTitle:NSLocalizedString(@"ok", nil)
                                                    otherButtonTitles:nil];
                [alert show];
            }
        });
    }];
}

- (void)saveToAlbumWithMetadata:(NSDictionary *)metadata
                      imageData:(NSData *)imageData
                customAlbumName:(NSString *)customAlbumName
                completionBlock:(void (^)(void))completionBlock
                   failureBlock:(void (^)(NSError *error))failureBlock {

    ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
    __weak ALAssetsLibrary *weakSelf = assetsLibrary;

    // 把已存在的資產加入指定相簿
    void (^AddAsset)(ALAssetsLibrary *, NSURL *) = ^(ALAssetsLibrary *assetsLibrary, NSURL *assetURL) {
        [assetsLibrary assetForURL:assetURL resultBlock:^(ALAsset *asset) {
            [assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
                if ([[group valueForProperty:ALAssetsGroupPropertyName] isEqualToString:customAlbumName]) {
                    [group addAsset:asset];
                    if (completionBlock) { completionBlock(); }
                }
            } failureBlock:^(NSError *error) {
                if (failureBlock) { failureBlock(error); }
            }];
        } failureBlock:^(NSError *error) {
            if (failureBlock) { failureBlock(error); }
        }];
    };

    [assetsLibrary writeImageDataToSavedPhotosAlbum:imageData metadata:metadata completionBlock:^(NSURL *assetURL, NSError *error) {
        if (customAlbumName) {
            [assetsLibrary addAssetsGroupAlbumWithName:customAlbumName resultBlock:^(ALAssetsGroup *group) {
                if (group) {
                    [weakSelf assetForURL:assetURL resultBlock:^(ALAsset *asset) {
                        [group addAsset:asset];
                        if (completionBlock) { completionBlock(); }
                    } failureBlock:^(NSError *error) {
                        if (failureBlock) { failureBlock(error); }
                    }];
                } else {
                    AddAsset(weakSelf, assetURL);
                }
            } failureBlock:^(NSError *error) {
                AddAsset(weakSelf, assetURL);
            }];
        } else {
            if (completionBlock) { completionBlock(); }
        }
    }];
}

這裡有兩個值得學的細節:一是用 __weak 避免 block 造成循環參照;二是把 UI 操作明確丟回主線程,因為 ALAssetsLibrary 的回呼可能在背景佇列執行。

三、關於 API 版本的現實提醒

ALAssetsLibrary 在 iOS 9 之後已被標記為棄用,取而代之的是 Photos 框架(PHPhotoLibrary、PHAssetCollection、PHAssetChangeRequest)。若你在撰寫新專案,請直接採用 Photos 框架:它支援更細緻的權限層級、iCloud 同步處理,也提供 PHPhotoLibraryChangeObserver 來監聽相冊變化。ALAssets 的寫法在維護舊專案時仍然用得到,理解它背後「先寫入、再歸類」的思路,遷移到新框架時會輕鬆許多。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved