探索 PhotoKit 的变更记录

PhotoKit 可以帮助您构建丰富的以照片为中心的功能。了解如何借助 PhotoKit 中的最新 API 轻松追踪对图片素材的变更。我们将介绍 PHPhotoLibrary 变更记录 API 并演示如何在每次启动时保留变更令牌，以帮助您的 App 识别用户照片图库新增和删除的内容，以及对照片图库的更新。要进一步了解照片图库集成，请务必观看 WWDC22 的“照片挑选器的新增内容”和 WWDC21 的“优化 App 中的照片访问”。

资源

相关视频

下载

♪ 柔和乐器演奏的嘻哈音乐 ♪ ♪ 您好我叫 Mindy 我是相册团队的工程师今天我将介绍如何在您的 App 中获得图片变更的历史记录 PhotoKit 提供了一组丰富的 API 用于对照片库中的照片、视频和相册进行访问和更新 PhotoKit 是专为需要深层访问和集成相册的 App 而设计的用于管理、编辑照片或自定义相机或构建让人们以独特的方式浏览照片库的 App 这些类型的 App 可能需要监控照片库随时间变化情况以便于更加密切的反映相册的内容假设我创建了一个社交远足 App 允许人们分享和编辑和朋友一起远足旅行的照片当有人启动 App 时该 App 通过获取从旅行开始到结束的时间戳收集最近一次远足时的手机照片并把他们在山上远足经历的生成拼贴画拼贴画与图片库中所选照片保持同步如果有人收到远足照片例如来自朋友的该 App 将使用这些更新照片生成新的拼贴画到目前为止为了让 App 发现新插入的图片资产并对以前的远足拼贴画进行更改该 App 需要执行一系列参数提取要确定插入了哪些图片资产该 App 需要能够获取图片资产创建日期晚于 App 最后一次启动日期的资产确定资产更新和删除的日期比较棘手该 App 需要重新获取每个拼贴中的每个图片资产并检查图片修改日期从而确定图片资产的更新时间但这可能会带来误报作为图片资产图片的修改时间可以由相册的内部处理活动设置照片库中的删除更难追踪因为需要提取所有跟踪的资产并对未随提取返回的资产进行区分总的来说这意味着每次启动 App 都需要做三个单独的检查如果 App 显示大量图片资产那么提取和计算开销会非常大而不是对不确定的结果进行不同的提取和检查如果有办法把确已发生的图片变化统一到一个 API 调用里会怎么样呢？好吧我很高兴地告诉您我们已经做到了！新的变更历史 API 允许以更简单的方式跟踪照片库的离线更新变更历史由变更时间线组成例如插入、更新和删除照片库在这个时间线示例中过去三天有各种资产、相簿和文件夹的更改保存于变更历史记录中使用此时间线您如何确定最近两天发生了哪些变化或者上一次您启动 App 的时间？您现在可以使用持久化更改令牌在给定的时间点表示照片库的状态此令牌可以在 App 启动时持久化并且它可用于获取该令牌生成后照片库的更改包括第三方 App 的修改请注意如果您的应用处于受限库模式则只有更改用户选择的 PhotoKit 对象会返回信息此更改令牌是设备本地的并且任何时候从持久化更改或图片库实例访问开销都会更小这个新的 API 在以下任何平台上都可用支持 PhotoKit 的平台有 macOS、iOS、iPadOS 和 tvOS 当您的 App 正在运行并使用照片库时您可以在 App 中存储持久化更改令牌您可以使用该令牌来获取此后发生的照片库更改对于每一个持久化更改您可以对于三种类型的相册对象获取更改详细信息资产、资产集合和集合列表那么这在代码中是什么样的呢？首先您需要使用上次存储的更改令牌获取持久化更改接下来您需要枚举并获取更改对象更改详细信息—— 在本例中每个持久化更改对象都是“asset”型这些更改详细信息提供了自更改令牌以来更新、删除和插入到照片库中的本地标识符的信息处理完这些改动后您可以存储最后一个更改令牌以供将来使用让我们对比一下新的持久化历史 API 和现有的改变观察者 API PHChanges 处理活动的内存中的获取结果并在您的 App 运行时用于记录照片库的实时更改另一方面持久化历史记录记录了对照片库的长期更改并可用于报告 App 不活动时的更改您可以根据您的 App 的需求同时使用这两种 API 或者任选其一回到远足应用示例我现在想使用持久化历史 API 跟踪资产变化以便于创建和更新远足拼贴画首先我将使用最后存储的更改令牌并获取持久化更改接下来我将遍历持久化更改抓取相关资产的变更明细然后进行插入、更新操作并删除标识符现在我需要从变更历史中识别出影响 App 的图片库更改因为 App 不需要获取更改返回的所有信息对 App 来说了解哪一个远足图片资产已加入到图片库以及哪些被更新和删除的资产在以前的远足拼贴画中引用过很重要我已经通过持久化更改生成了三个枚举定义插入、更新和删除资产的本地标识符我现在如何更新 App 以反映这些状态？使用插入标识符集我可以通过获取每次远足的开始和结束日期通过远足图片资产的插入时间戳和他们的创建时间来确定添加了哪些资产更新后的资产可能会进行调整所以我可以使用新的 hasAdjustments API 检查我是否需要在 UI 中重绘资产我可以使用已删除资产的本地标识符以确定哪些拼贴画需要重新生成现在我已经处理了所有离线照片库的更改并且我的 App 的内容是最新的以下是当您使用新的变更历史 API 时应该记住的几件事首先确定哪些更改对您和您的 App 很重要并且只检查这些更改考虑执行一个更新和插入资产的大型获取请求以提高性能而不是用多个较小的请求照片库的内容可能会因处理和后台同步活动而发生很大变化所以您最终可能会在大量变化中进行枚举尤其是当您的 App 不经常启动正因为如此我们推荐您在后台线程上请求更改历史记录以避免阻塞 UI 在获取持久化历史记录时可能发生两种类型的错误如果更改令牌比更改的可用历史记录更早将返回更改令牌过期的报错在某些情况下持久化更改不能依赖于完全重建所发生的更改并将返回更改详细信息不可用的报错在这些情况下我们建议重新获取照片库中的跟踪对象以确保您的应用的内容是最新的在我们结束之前还有一些我想与您分享新的 PhotoKit API 的内容 PhotoKit 现在支持按媒体子类型和智能相册访问电影视频还有两个新的错误代码如果照片库绑定在 macOS 系统的 File Provider 同步根目录下图片库可能会损坏尝试执行更改时将返回错误如果由于网络问题找不到资产资源资源请求将返回网络错误的报错请在开发者文档查看所有最新的更新最后一定要在相册选取器中看看今年的会议因为它是使用和访问相册的最简单方法我们很高兴您能使用新的变更历史 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