PhotoKitの変更履歴について

PhotoKitにより、写真を中心とした豊富な機能を構築できるようになります。PhotoKitの最新APIを使用して、画像アセットへの変更を簡単に追跡する方法について解説します。さらに、PHPhotoLibraryのchange historyAPIを紹介し、起動時に変更トークンを保持する方法、Appで他のユーザの写真ライブラリへの追加、削除、更新を認識できるようにする方法についても紹介します。写真ライブラリの統合に関する詳細については、WWDC22の「写真ピッカーの最新情報」と、WWDC21の「App内の写真アクセスの改善」をご覧ください。

リソース

関連ビデオ

ダウンロード

♪ 落ち着いたヒップホップの曲 ♪ ♪ PhotosチームのエンジニアのMindyです今日は Appで写真の変更履歴にアクセスする方法を説明します PhotoKitの豊富なAPIセットでは写真ライブラリの写真ビデオアルバムへのアクセスと更新が可能です PhotoKitは深いレベルで写真へのアクセスと統合が必要なApp向けに設計されています写真の管理と編集のための AppやカスタムカメラApp 写真のライブラリを独自の方法で閲覧できるAppなどですこのようなタイプの Appでは写真ライブラリの変化を監視し写真のエクスペリエンスを忠実に反映したいものですハイキング用SNSを作ったとしましょう友達とハイキングの写真を共有･編集できるAppです Appを起動すると最近のハイキングの開始と終了のタイムスタンプから写真が集められ山の体験のコラージュが生成されます写真ライブラリから選択された写真とコラージュは同期していますハイキングの写真を友人から受け取るとその更新を使用して新しいコラージュを作りますこれまでは Appが新しいアセットの挿入や既存のコラージュへの変更を検出するには一連の取得の実行が必要でした挿入されたアセットを判別するには作成日が最後のApp起動日より新しいアセットを取得しますアセットの更新や削除の判別はより困難です全コラージュ内の全アセットを再取得し変更日をチェックしてアセットの更新を判別しますただしアセットの変更日は写真の内部の処理作業で設定されうるため誤検知の可能性もあります写真ライブラリ内の削除は追跡がより困難です追跡対象の全アセットを取得し返されなかったアセットの差分を取りますつまり 3つの別々のチェックが Appを起動するたびに必要になります大量のアセットを表示するAppでは特にコストがかかります様々な取得とチェックを実行して不確かな結果を得る代わりに 1回の統一された APIの呼び出しで変更点を正確に知る方法があったら？私たちはまさにそれを実現しました新しいchange history APIを使えば簡単に写真ライブラリのオフライン更新を追跡できます変更履歴は写真ライブラリへの挿入更新削除などの変更のタイムラインで構成されていますこのタイムラインの例では過去3日間の変更履歴にアセットアルバムフォルダの様々な変更がありますこのタイムラインを使い過去2日間のまたは Appの最終起動時の変更を判別するにはどうしたらよいでしょう？永続的変更トークンが使用可能になりましたある時点の写真ライブラリの状態を示すものですこのトークンは App終了後も保持されそのトークン以降の写真ライブラリの変更を取得するのに使用できますサードパーティAppの変更も含みます Appのライブラリへのアクセスが制限されている場合はユーザーが選択した PhotoKitオブジェクトの変更のみが返されますこの変更トークンはデバイスローカルで永続的変更や写真ライブラリのインスタンスからいつでも簡単にアクセスできますこの新APIの利用は PhotoKit対応の macOS・iOS・iPadOS・tvOS 全プラットフォームで可能です Appの実行時写真ライブラリの操作中に App内に永続的変更トークンを保存できます後でそのトークンを使用し写真ライブラリの以降の変更を取得できます永続的変更ごとに写真オブジェクトの3種類の詳細を取得できますアセット・アセットコレクションコレクションリストですこれはコードではどうなるでしょう？まず最後に保存されたトークンを使用し永続的変更を取得します次に永続的変更を列挙し変更の詳細ここでは “アセット”タイプを永続的変更オブジェクトごとに取得しますこれらの変更の詳細にはトークン以降に更新削除写真ライブラリへの挿入が行われたローカル識別子の情報が含まれていますこれらの変更の処理後今後使うために最後の変更トークンを保存できます新しい永続的な change history APIと従来のchange observer APIを比較しましょう PHChangeはアクティブなメモリ内の取得結果を処理し Appの実行中に写真ライブラリへのライブ変更を記録します一方永続的な change history APIは写真ライブラリへの変更を長期間記録し Appの非アクティブ時の変更履歴を報告できます開発するAppの要件に応じてこれらのAPIの両方またはどちらかを使用できますハイキングAppの例に戻ります永続的なchange history APIを使ってアセットの変更を追跡しハイキングのコラージュを作成･更新しますまず最後に保存された変更トークンを使用し永続的変更を取得します次に永続的変更を繰り返し処理し関連アセットの変更の詳細を取得し挿入更新削除が行われた識別子を処理しますここで Appに影響する写真ライブラリの変更を変更履歴から特定する必要があります取得された変更の全情報まではこのAppでは必要としないためですこのAppで重要なのは最近のハイキングで追加されたアセットと以前のコラージュで参照された後更新削除されたアセットを知ることです挿入・更新・削除されたアセットのローカル識別子の 3セットは永続的変更の列挙で特定しましたがこれを反映するように Appを更新するには？ InsertedIdentifiersセットを使用するとハイキングのタイムスタンプの間に挿入したアセットを特定できます挿入したアセットの作成日を各ハイキングの開始･終了日と照合するのです更新したアセットは調整された可能性があるので新しいhasAdjustments APIを使用して UIでアセットの再描画が必要かどうかを確認します削除されたアセットはローカル識別子を使用して再生成が必要なコラージュを決定できますこれでオフラインの写真ライブラリの変更をすべて処理し Appは最新の状態になりました新しいchange history APIを使用する際に留意すべき点がいくつかありますまずあなたとあなたのAppにとって重要な変更のみを確認することパフォーマンス向上のために複数回の小さなリクエストではなく大きな取得リクエスト1回の実行を検討すること写真ライブラリは内部処理と同期により大幅に変更される可能性があるため特に Appが頻繁に起動されない場合は大量の変更を列挙する可能性があります UIをブロックしないようバックグラウンドスレッドで変更履歴を要求することをお勧めします永続的変更履歴を取得する際に発生する可能性のあるエラーは2種類変更トークンが利用可能な変更履歴よりも古い場合期限切れの変更トークンエラーが返されます永続的変更に基づいてこれまでの変更の完全な再構築が行えない場合には変更の詳細が利用できないというエラーが返されますこのような場合写真ライブラリの追跡オブジェクトを再取得し Appが最新か確認してください最後に PhotoKitの新しいAPIをさらにいくつか紹介します Media subtypeと Smart albumによりシネマティックモードのビデオにアクセス可能に新しいエラーコードも 2つ追加されました写真ライブラリが macOSの File Provider同期ルートディレクトリにある場合ライブラリが破損する恐れがあり変更を実行しようとするとエラーが返されますネットワークの問題でアセットリソースが見つからない場合はリソースリクエストにネットワークエラーが返されます最新のアップデートについてはデベロッパ向けドキュメントをご確認ください最後にぜひ今年の写真ピッカーのセッションをご覧ください写真の操作とアクセスが一番簡単になる方法です新しいchange history APIと PhotoKitの素晴らしい新機能をご利用いただくのが楽しみですありがとうございました ♪

0:01 - Tracking photo library changes

// Discover added assets
let options = PHFetchOptions()
options.predicate = NSPredicate(format: "creationDate > %@", lastLaunchDate as CVarArg)
let insertedAssets = PHAsset.fetchAssets(with: options)

0:02 - Tracking photo library changes (2)

let fetchResult = PHAsset.fetchAssets(with: localIdentifiers, options: nil)
// Discover all modified and deleted assets
fetchResult.enumerateObjects { asset, idx, stop in
    if asset.modificationDate?.compare(lastLaunchDate) == .orderedDescending {
        // Asset could have been modified
    }
    if !localIdentifiers.contains(asset.localIdentifier) {
        // Asset could have been deleted
    }
}

0:03 - Fetching persistent changes using persistent change token

let persistentChanges = try! PHPhotoLibrary.shared().fetchPersistentChanges(since: self.lastStoredToken)

for persistentChange in persistentChanges { 
   if let changeDetails = persistentChange.changeDetails(for: PHObjectType.asset) {
        let updatedIdentifiers = changeDetails.updatedLocalIdentifiers
        let deletedIdentifiers = changeDetails.deletedLocalIdentifiers
        let insertedIdentifiers = changeDetails.insertedLocalIdentifiers
    }
}

// After processing change details
self.lastStoredToken = lastPersistentChange.changeToken

0:04 - Identifying important changes

// Get last stored change token
let changeToken = self.lastStoredToken

// Fetch persistent changes
let persistentChanges = try!   
         library.fetchPersistentChanges(since: changeToken)

for persistentChange in persistentChanges {
    // Grab change details and process updates
}

0:05 - Using inserted identifiers

let insertedAssets = PHAsset.fetchAssets(with: insertedIdentifiers, options: nil)
insertedAssets.enumerateObjects { asset, idx, stop in
   for hike in hikes {
        let dateInterval = NSDateInterval(start: hike.startDate, end: hike.endDate)
        if dateInterval.contains(asset.creationDate) {
            // This hike contains a new added asset
        }
    }
}

0:06 - Using updated identifiers

let updatedAssets = PHAsset.fetchAssets(with: updatedIdentifiers, options: nil)
updatedAssets.enumerateObjects { asset, idx, stop in
    if asset.hasAdjustments {
        // This asset has edits
    }
}

0:07 - Using deleted identifiers

for deletedIdentifier in deletedIdentifiers {
    for collage in collages {
        if collage.assetLocalIdentifiers.contains(deletedIdentifier) {
            // This collage needs to be redrawn
        }
    }
}

0:08 - Handling errors

do {
    let persistentChanges = try library.fetchPersistentChanges(since: changeToken)
} catch PHPhotosError.persistentChangeTokenExpired,
        PHPhotosError.persistentChangeDetailsUnavailable {
    let fetchResult = PHAsset.fetchAssets(with: trackedIdentifiers, options: options)
    // Use fetch result
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

PhotoKitの変更履歴について

リソース

関連ビデオ

WWDC23

WWDC22

WWDC21