该参考面向 iOS 与 SwiftUI/UIKit 开发,整理系统照片图库相关 API 的用法片段、属性表与限制说明。
用途:是苹果照片图库 API 的速查参考,覆盖选择器、权限、读取、写入与变更监听等主题,适合开发照片选择、保存到相册、自定义相册等功能的开发者查阅。
主要能力:涵盖 PHPickerViewController/PHPickerConfiguration(iOS 14+,无需权限)、SwiftUI PhotosPicker/PhotosPickerItem(iOS 16+,无需权限)、PHPhotoLibrary 权限与变更、PHAsset 获取与属性、PHAssetCreationRequest 写入、PHFetchResult 遍历、PHImageManager 请求图片与视频、PHChange 变更监听等;包含筛选、选择行为、嵌入式选择器、HDR 保留、延迟照片代理(iOS 17+)等配置。
使用方式:文中给出 Swift 代码片段,例如用 PhotosPicker(selection:matching:) 选择图片并通过 loadTransferable(type: Data.self) 读取;用 PHPickerConfiguration 配置选择限制与过滤;用 PHPhotoLibrary.shared().performChanges 与 PHAssetCreationRequest 写入相册;用 PHPhotoLibrary.authorizationStatus(for: .readWrite) 检查权限。命令与代码保持原样。
适用场景:需要在 iOS/macOS 应用内集成照片选择、读取元数据、保存到相册或监听图库变更时参考。
限制:需按平台与系统版本选择 API;写入、读取完整图库通常需要授权,选择器在部分配置下无需权限;iCloud 照片请求可能需开启网络访问;文档未涉及价格、平台支持范围与外部依赖等信息,暂未提供。