在上一篇,有講到 PHFetchOptions、PHPhotoLibraryChangeObserver、PHImageManager
在這一篇,會講到 PHAsset、PHAssetResource
PHAsset 記錄著一張照片/影片的各項資訊,像是建立時間、變動時間、媒體型態、拍攝位置、收藏狀態等
讓我們一起來看一下 PHAsset 究竟記錄著哪些資訊
@available(iOS 8, *)
open class PHAsset : PHObject {
// enum,顯示媒體給使用者的方式
@available(iOS 11, *)
open var playbackStyle: PHAsset.PlaybackStyle { get }
// enum,媒體種類
@available(iOS 8, *)
open var mediaType: PHAssetMediaType { get }
// enum,媒體子種類
@available(iOS 8, *)
open var mediaSubtypes: PHAssetMediaSubtype { get }
// 媒體的寬度
@available(iOS 8, *)
open var pixelWidth: Int { get }
// 媒體的高度
@available(iOS 8, *)
open var pixelHeight: Int { get }
// 媒體的建立時間
@available(iOS 8, *)
open var creationDate: Date? { get }
// 媒體的變動時間
@available(iOS 8, *)
open var modificationDate: Date? { get }
// 拍攝媒體的位置
@available(iOS 8, *)
open var location: CLLocation? { get }
// 影片媒體的時間長度
@available(iOS 8, *)
open var duration: TimeInterval { get }
// 媒體是否隱藏
@available(iOS 8, *)
open var isHidden: Bool { get }
// 媒體是否收藏
@available(iOS 8, *)
open var isFavorite: Bool { get }
// 連拍照片的標示符
@available(iOS 8, *)
open var burstIdentifier: String? { get }
// enum,連拍照片的種類
@available(iOS 8, *)
open var burstSelectionTypes: PHAssetBurstSelectionType { get }
// 是否為連拍照片的代表性照片
@available(iOS 8, *)
open var representsBurst: Bool { get }
// enum,媒體來源種類
@available(iOS 9, *)
open var sourceType: PHAssetSourceType { get }
// 調整格式的標示符
@available(iOS 15, *)
unowned(unsafe) open var adjustmentFormatIdentifier: NSString? { get }
@available(iOS 8, *)
open func canPerform(_ editOperation: PHAssetEditOperation) -> Bool
@available(iOS 8, *)
open class func fetchAssets(in assetCollection: PHAssetCollection, options: PHFetchOptions?) -> PHFetchResult<PHAsset>
@available(iOS 8, *)
open class func fetchAssets(withLocalIdentifiers identifiers: [String], options: PHFetchOptions?) -> PHFetchResult<PHAsset>
@available(iOS 8, *)
open class func fetchKeyAssets(in assetCollection: PHAssetCollection, options: PHFetchOptions?) -> PHFetchResult<PHAsset>?
@available(iOS 8, *)
open class func fetchAssets(withBurstIdentifier burstIdentifier: String, options: PHFetchOptions?) -> PHFetchResult<PHAsset>
@available(iOS 8, *)
open class func fetchAssets(with options: PHFetchOptions?) -> PHFetchResult<PHAsset>
@available(iOS 8, *)
open class func fetchAssets(with mediaType: PHAssetMediaType, options: PHFetchOptions?) -> PHFetchResult<PHAsset>
}
PHAsset.PlaybackStyle:顯示媒體給使用者的方式
@available(iOS 11, iOS 8, *)
public enum PlaybackStyle : Int {
// 不支援或是未定義的媒體類型
@available(iOS 8, *)
case unsupported = 0
// 照片
@available(iOS 8, *)
case image = 1
// 動畫圖片
@available(iOS 8, *)
case imageAnimated = 2
// 原況照片
@available(iOS 8, *)
case livePhoto = 3
// 影片
@available(iOS 8, *)
case video = 4
// 循環播放的影片
@available(iOS 8, *)
case videoLooping = 5
}
PHAssetMediaType:媒體種類
@available(iOS 8, iOS 8, *)
public enum PHAssetMediaType : Int {
// 未知
@available(iOS 8, *)
case unknown = 0
// 照片
@available(iOS 8, *)
case image = 1
// 影片
@available(iOS 8, *)
case video = 2
// 音檔
@available(iOS 8, *)
case audio = 3
}
PHAssetMediaSubtype:媒體子種類
@available(iOS 8, iOS 8, *)
public struct PHAssetMediaSubtype : OptionSet {
public init(rawValue: UInt)
// 照片子類別
// 全景照片
@available(iOS 8, *)
public static var photoPanorama: PHAssetMediaSubtype { get }
// HDR 照片
@available(iOS 8, *)
public static var photoHDR: PHAssetMediaSubtype { get }
// 螢幕截圖
@available(iOS 9, *)
public static var photoScreenshot: PHAssetMediaSubtype { get }
// 原況照片
@available(iOS 9.1, *)
public static var photoLive: PHAssetMediaSubtype { get }
// 人像模式照片
@available(iOS 10.2, *)
public static var photoDepthEffect: PHAssetMediaSubtype { get }
// 影片子類別
// 網路串流影片
@available(iOS 8, *)
public static var videoStreamed: PHAssetMediaSubtype { get }
// 高幀率影片
@available(iOS 8, *)
public static var videoHighFrameRate: PHAssetMediaSubtype { get }
// 縮時影片
@available(iOS 8, *)
public static var videoTimelapse: PHAssetMediaSubtype { get }
// 電影模式影片
@available(iOS 15, *)
public static var videoCinematic: PHAssetMediaSubtype { get }
}
PHAssetBurstSelectionType:連拍照片的種類
@available(iOS 8, iOS 8, *)
public struct PHAssetBurstSelectionType : OptionSet {
public init(rawValue: UInt)
// 系統自動選擇的
@available(iOS 8, *)
public static var autoPick: PHAssetBurstSelectionType { get }
// 使用者自己選擇的
@available(iOS 8, *)
public static var userPick: PHAssetBurstSelectionType { get }
}
PHAssetResource 是在 Photo Library 中的底層資料,與 PHAsset 是相互關聯的
@available(iOS 9, *)
open class PHAssetResource : NSObject {
// 媒體資源種類
@available(iOS 9, *)
open var type: PHAssetResourceType { get }
// 系統為本地資產對象關聯的唯一標識符
@available(iOS 9, *)
open var assetLocalIdentifier: String { get }
// 照片或影片資料的統一類型標識符
@available(iOS 9, *)
open var uniformTypeIdentifier: String { get }
// 建立或是匯入時的原始檔名
@available(iOS 9, *)
open var originalFilename: String { get }
@available(iOS 9, *)
open class func assetResources(for asset: PHAsset) -> [PHAssetResource]
@available(iOS 9.1, *)
open class func assetResources(for livePhoto: PHLivePhoto) -> [PHAssetResource]
}
@available(iOS 9, iOS 8, *)
public enum PHAssetResourceType : Int {
// 原始照片 (未修改過的)
@available(iOS 8, *)
case photo = 1
// 原始影片 (未修改過的)
@available(iOS 8, *)
case video = 2
// 原始音檔 (未修改過的)
@available(iOS 8, *)
case audio = 3
// 非主要的照片
// Ex:其他相機傳來的照片,可能同時具有 JPEG 跟 RAW 檔
// JPEG 為主要照片,RAW 為備用照片
@available(iOS 8, *)
case alternatePhoto = 4
// 原始照片 (修改過的)
@available(iOS 8, *)
case fullSizePhoto = 5
// 原始影片 (修改過的)
@available(iOS 8, *)
case fullSizeVideo = 6
// 紀錄編輯時的資料
@available(iOS 8, *)
case adjustmentData = 7
// 未更改的照片,用來回復最近的編輯狀態
@available(iOS 8, *)
case adjustmentBasePhoto = 8
// 原況照片 (未修改過的)
@available(iOS 9.1, *)
case pairedVideo = 9
// 原況照片 (修改過的)
@available(iOS 10, *)
case fullSizePairedVideo = 10
// 未更改的原況照片,用來回復最近的編輯狀態
@available(iOS 10, *)
case adjustmentBasePairedVideo = 11
// 未更改的影片,用來回復最近的編輯狀態
@available(iOS 13, *)
case adjustmentBaseVideo = 12
}
下一篇,再來介紹要如何應用~
https://developer.apple.com/documentation/photokit
https://www.jianshu.com/p/3ac116ffffcc