[iOS 8] PhotoKit 3 – Photos Framework – モデルオブジェクトのプロパティの編集

iOS 8 特集解説記事 200本公開中!!

平屋真吾

2014.09.18

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

はじめに

今回はモデルオブジェクトの編集を扱います。

Photos Frameworkのモデルオブジェクトはメタデータだけ保持し、メタデータを取得するためのプロパティは読み取り専用になっています。プロパティやコンテンツ(写真やビデオの実データ)の編集は、編集作業用のオブジェクトを使って行います。

PHAssetのプロパティの編集

変更可能なプロパティには以下のようなものがあります

favorite (お気に入り登録済みかどうか、BOOL)
location (場所、CLLocation)
creationDate (作成日、NSDate)

今回はfavoriteプロパティの編集を行ってみます。

Assetを編集するにはまず、そのAssetが編集処理をサポートしているかを、 PHAssetクラスのcanPerformEditOperation:メソッドを使用して問い合わせます。編集処理がサポートされていたら PHPhotoLibraryクラスのperformChanges:completionHandler:メソッドの１つ目の引数のblock内に編集処理を記述します。 (PHPhotoLibraryはPhoto libraryを表すオブジェクトで、sharedPhotoLibraryメソッドでユーザーのPhoto libraryを取得できます。) 今回はfavoriteプロパティの編集を行うので、 PHAssetChangeRequestを作成し、favoriteプロパティの変更を指定します。

処理完了時の処理は、performChanges:completionHandler:メソッドの２つめのblockに記述します。

// 編集処理がサポートされているかを問い合わせる
// 引数にPHAssetEditOperationPropertiesを指定
if ([self.asset canPerformEditOperation:PHAssetEditOperationProperties]) {
    // Assetの編集を実行
    [[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
        // PHAssetChangeRequestを作成、favoriteプロパティの変更を指定
        PHAssetChangeRequest *request = [PHAssetChangeRequest changeRequestForAsset:self.asset];
        [request setFavorite:![self.asset isFavorite]];
        NSLog(@"%s setFavorite %@", __PRETTY_FUNCTION__, ([self.asset isFavorite] ? @"YES to NO": @"NO to YES"));
    } completionHandler:^(BOOL success, NSError *error) {
        if (!success) {
            NSLog(@"%s setFavorite Error: %@", __PRETTY_FUNCTION__, error);
        } else {
            NSLog(@"%s setFavorite success", __PRETTY_FUNCTION__);
        }
    }];
}

今回登場したクラスやメソッド

PHAsset

canPerformEditOperation:
- 編集処理をサポートしているかどうかを返す

PHPhotoLibrary

Photo libraryを表すオブジェクト
sharedPhotoLibraryメソッドでユーザーのPhoto libraryを取得可能
- Photos appによって管理されている全てのcollection／assetを含む
- 端末内／iCloud上のcollection／assetオブジェクトを含む
編集を実行するためのメソッドが用意されている
- できることの例：
  - assetのメタデータやコンテンツの編集
  - 新しいassetの追加
  - collectionの構成の編集