實(shí)戰(zhàn):利用AVFoundation與Photos框架實(shí)現(xiàn)視頻轉(zhuǎn)Live Photo)
你是不是也遇到過這種情況手機(jī)里存了一段特別有感覺的短視頻想把它設(shè)置成 iPhone 的 Live Photo實(shí)況照片讓鎖屏壁紙動起來卻發(fā)現(xiàn)系統(tǒng)自帶的“實(shí)況”功能只能拍照不支持視頻導(dǎo)入網(wǎng)上找的轉(zhuǎn)換工具要么收費(fèi)要么有水印要么操作復(fù)雜得讓人頭疼。今天我們不談那些復(fù)雜的商業(yè)工具而是帶你從零開始親手打造一個(gè)屬于你自己的、完全免費(fèi)的“視頻轉(zhuǎn) Live Photo”App。整個(gè)過程你不需要是 iOS 開發(fā)大神甚至不需要懂復(fù)雜的圖像處理算法。我們將借助兩個(gè)強(qiáng)大的“外掛”image2和Codex。image2是一個(gè)能理解圖像內(nèi)容的 AI 模型而Codex則是 OpenAI 推出的代碼生成模型GPT-3 的編程特化版。聽起來很高深別怕我們的核心思路是用自然語言描述你的需求讓 Codex 生成大部分代碼再用 image2 處理視頻關(guān)鍵幀最后由 Xcode 打包成 App。這篇文章就是一份詳細(xì)的“地圖”告訴你每一步怎么走坑在哪里如何避開。讀完本文你將獲得一個(gè)可運(yùn)行的、將 MP4 視頻轉(zhuǎn)換為 iPhone 可識別的 Live Photo.mov .jpg的完整 iOS App 項(xiàng)目。一套利用 AI 輔助進(jìn)行應(yīng)用開發(fā)的實(shí)戰(zhàn)方法論而不僅僅是調(diào)用某個(gè) API。對 Core Media、AVFoundation 等 iOS 多媒體框架關(guān)鍵操作的理解。從設(shè)計(jì)、編碼、調(diào)試到最終打包上架或自簽的完整流程體驗(yàn)。我們開始吧。1. 這篇文章真正要解決的問題很多教程教你“如何使用某個(gè)庫”但很少告訴你“如何從想法到產(chǎn)品”。本文要解決的遠(yuǎn)不止技術(shù)實(shí)現(xiàn)而是三個(gè)層面的問題1. 功能實(shí)現(xiàn)問題如何將一段普通的 MP4 視頻轉(zhuǎn)換成 iPhone 系統(tǒng)相冊能正確識別、播放和設(shè)置為壁紙的 Live Photo這涉及到對 Live Photo 本質(zhì)一個(gè)短視頻一張封面圖元數(shù)據(jù)的理解以及對 iOS 媒體庫操作 API 的掌握。2. 開發(fā)效率問題對于不熟悉 iOS 多媒體開發(fā)的開發(fā)者或者想快速驗(yàn)證想法的產(chǎn)品經(jīng)理、設(shè)計(jì)師從頭閱讀蘋果冗長的文檔效率太低。我們能否利用 AICodex來理解我們的意圖并生成大部分“樣板代碼”和“復(fù)雜邏輯代碼”我們只負(fù)責(zé)核心業(yè)務(wù)邏輯的串聯(lián)和調(diào)試3. 工程化與踩坑指南網(wǎng)上搜索“Live Photo 轉(zhuǎn)換”你會找到很多零散的代碼片段但缺乏一個(gè)完整的、可編譯運(yùn)行的 Xcode 工程更缺少對權(quán)限申請、內(nèi)存管理、文件格式兼容性、真機(jī)調(diào)試等實(shí)際問題的系統(tǒng)性講解。本文將提供一個(gè)完整的項(xiàng)目腳手架并重點(diǎn)標(biāo)注那些官方文檔語焉不詳、但實(shí)際開發(fā)中一定會遇到的“坑”。適合誰讀iOS 開發(fā)新手想通過一個(gè)有趣的項(xiàng)目快速上手 AVFoundation 和 Photos 框架。全?;蚯岸碎_發(fā)者對移動端開發(fā)感興趣想了解一個(gè)完整 iOS App 的構(gòu)建流程。獨(dú)立開發(fā)者或創(chuàng)業(yè)者有一個(gè)小工具 App 的想法希望用最低成本快速實(shí)現(xiàn)原型。對 AI 輔助編程感興趣的人想看看 Codex 在實(shí)際項(xiàng)目開發(fā)中到底能幫到什么程度。2. 基礎(chǔ)概念與核心原理在動手寫代碼之前我們必須搞清楚幾個(gè)關(guān)鍵概念這是避免后續(xù)走彎路的基礎(chǔ)。2.1 Live Photo 到底是什么很多人誤以為 Live Photo 就是一個(gè) GIF 或者短循環(huán)視頻。其實(shí)不然。一個(gè) Live Photo 在文件系統(tǒng)層面是兩個(gè)獨(dú)立文件加上一套元數(shù)據(jù)視頻文件一個(gè)時(shí)長約 3 秒的.mov格式視頻文件包含了畫面和聲音。這是“動起來”的部分。封面圖片文件一張.jpg或.heic格式的靜態(tài)圖片通常是從視頻中間截取的一幀。這是你預(yù)覽時(shí)看到的部分。配對標(biāo)識符一套元數(shù)據(jù)存儲在PHAsset或文件系統(tǒng)的AssetResource中將上述兩個(gè)文件關(guān)聯(lián)起來告訴系統(tǒng)“這個(gè) .mov 和這個(gè) .jpg 屬于同一個(gè) Live Photo”。所以轉(zhuǎn)換的核心任務(wù)就是從輸入視頻中提取一段短視頻和一張封面圖生成這兩個(gè)文件并創(chuàng)建正確的關(guān)聯(lián)關(guān)系最后導(dǎo)入到系統(tǒng)相冊。2.2 image2 與 Codex 在本項(xiàng)目中的角色這里容易產(chǎn)生一個(gè)誤解認(rèn)為 image2 是直接處理視頻的。其實(shí)不然我們需要明確分工image2 的角色視覺內(nèi)容理解與處理關(guān)鍵幀提取從長視頻中智能選擇最具代表性、畫質(zhì)最好的一幀作為 Live Photo 的封面圖。這比簡單取第一幀或中間幀效果更好。畫面分析可選未來可以擴(kuò)展功能例如分析視頻內(nèi)容自動添加相關(guān)標(biāo)簽或者根據(jù)內(nèi)容推薦合適的封面幀。在本項(xiàng)目中我們可以將 image2 視為一個(gè)“智能截圖工具”。雖然我們最終會使用AVFoundation的AVAssetImageGenerator來實(shí)際截取幀但 image2 的選幀邏輯思想可以借鑒。Codex 的角色代碼生成與輔助開發(fā)生成樣板代碼例如創(chuàng)建UIViewController、設(shè)置UITableView的DataSource、編寫文件選擇器的標(biāo)準(zhǔn)代碼。這些重復(fù)性工作可以交給 Codex。解釋復(fù)雜 API當(dāng)你對PHLivePhoto、PHAssetCreationRequest等 API 的用法不熟悉時(shí)可以用自然語言向 Codex 提問讓它生成示例代碼。調(diào)試助手將錯(cuò)誤日志貼給 Codex讓它幫你分析可能的原因。在本項(xiàng)目中我們將主要用 Codex 來生成文件管理、權(quán)限申請、相冊寫入等模塊的初始代碼加快開發(fā)速度。核心原理流程圖用戶選擇MP4視頻 - App讀取視頻 - 使用AVFoundation截取3秒片段 - 生成.mov文件 | - 使用AVFoundation/借鑒image2思想選取關(guān)鍵幀 - 生成.jpg文件 | - 使用Photos框架將.mov和.jpg配對 - 創(chuàng)建Live Photo - 保存至相冊3. 環(huán)境準(zhǔn)備與前置條件工欲善其事必先利其器。以下是開發(fā)本應(yīng)用所需的全部環(huán)境。3.1 硬件與系統(tǒng)Mac 電腦必須是 macOS 系統(tǒng)用于運(yùn)行 Xcode。iPhone 或 iPad可選但強(qiáng)烈推薦用于真機(jī)調(diào)試和功能驗(yàn)證。模擬器無法測試相冊寫入等部分功能。操作系統(tǒng)macOS Monterey (12.x) 或更高版本。建議使用最新穩(wěn)定版。3.2 軟件與工具Xcode從 Mac App Store 下載并安裝最新穩(wěn)定版本如 15.x。這是 iOS 開發(fā)的唯一官方 IDE。Apple Developer Account一個(gè)免費(fèi)的 Apple ID 即可用于真機(jī)調(diào)試。如果需要上架 App Store則需要加入付費(fèi)的 Apple Developer Program年費(fèi) 99 美元。本文以真機(jī)調(diào)試為目標(biāo)。Python 環(huán)境可選用于模擬 image2 邏輯如果你打算在服務(wù)端或本地腳本中實(shí)現(xiàn)更復(fù)雜的關(guān)鍵幀選取算法可以安裝 Python。但在本文的純客戶端實(shí)現(xiàn)中非必需。3.3 知識預(yù)備基本的 Swift 語法了解變量、函數(shù)、類、閉包等概念。對 iOS 開發(fā)有初步認(rèn)識知道什么是ViewController、Storyboard/SwiftUI、IBOutlet。如果這些你都不熟沒關(guān)系跟著步驟做Codex 生成的代碼會有詳細(xì)注釋你可以邊做邊學(xué)。4. 創(chuàng)建 Xcode 項(xiàng)目與基礎(chǔ)配置讓我們打開 Xcode從零開始。4.1 新建項(xiàng)目打開 Xcode選擇 “Create a new Xcode project”。模板選擇 “App”點(diǎn)擊 Next。填寫項(xiàng)目信息Product Name:LivePhotoConverter(或其他你喜歡的名字)Team: 選擇你的 Apple ID 賬戶如果沒有點(diǎn)擊 “Add Account…” 添加。Organization Identifier: 通常使用反寫域名格式如com.yourname。Interface: 選擇SwiftUI更現(xiàn)代代碼更簡潔。如果你想用 UIKit也可以但本文以 SwiftUI 為例。Language: 選擇Swift。不要勾選“Use Core Data”, “Include Tests” 等選項(xiàng)保持項(xiàng)目簡潔。選擇項(xiàng)目保存的位置點(diǎn)擊 Create。4.2 配置項(xiàng)目權(quán)限Live Photo 轉(zhuǎn)換需要訪問用戶的相冊寫入和文件讀取視頻。必須在Info.plist中添加相應(yīng)的權(quán)限描述。在項(xiàng)目導(dǎo)航器中點(diǎn)擊LivePhotoConverter項(xiàng)目藍(lán)色圖標(biāo)選擇Info標(biāo)簽頁。在 “Custom iOS Target Properties” 區(qū)域點(diǎn)擊號添加以下兩項(xiàng)KeyTypeValuePrivacy - Photo Library Usage DescriptionString需要訪問相冊來保存生成的 Live Photo。Privacy - Photo Library Additions Usage DescriptionString需要向相冊添加新的 Live Photo。為什么需要兩個(gè)第一個(gè)是“讀取和使用”相冊的權(quán)限第二個(gè)是“僅添加”權(quán)限。對于只寫入不讀取的場景使用第二個(gè)更合適系統(tǒng)提示對用戶更友好。4.3 初始項(xiàng)目結(jié)構(gòu)創(chuàng)建完成后你的項(xiàng)目應(yīng)該包含以下主要文件LivePhotoConverterApp.swift: App 的入口文件。ContentView.swift: 主視圖文件我們將在這里構(gòu)建界面。Assets.xcassets: 資源文件夾可以放應(yīng)用圖標(biāo)。Info.plist: 配置文件。5. 核心功能模塊設(shè)計(jì)與實(shí)現(xiàn)我們將功能拆解為四個(gè)模塊1. 用戶界面2. 視頻選擇與讀取3. 視頻處理與文件生成4. Live Photo 合成與保存。5.1 模塊一構(gòu)建用戶界面 (SwiftUI)我們將創(chuàng)建一個(gè)簡單的界面一個(gè)按鈕用于選擇視頻一個(gè)顯示選中視頻名的文本一個(gè)進(jìn)度條一個(gè)轉(zhuǎn)換按鈕和一個(gè)顯示狀態(tài)的文本。打開ContentView.swift將其替換為以下代碼。這里就是 Codex 可以大顯身手的地方。你可以嘗試在 ChatGPT具備 Codex 能力或 GitHub Copilot 中輸入“用 SwiftUI 寫一個(gè)視圖包含一個(gè)選擇視頻的按鈕一個(gè)顯示視頻名的文本一個(gè)轉(zhuǎn)換按鈕一個(gè)進(jìn)度條和一個(gè)狀態(tài)文本?!?它會生成非常接近的代碼。我們在此基礎(chǔ)上進(jìn)行調(diào)整。// 文件ContentView.swift import SwiftUI import PhotosUI // 用于選擇視頻 struct ContentView: View { // 狀態(tài)變量 State private var selectedVideo: PhotosPickerItem? nil State private var selectedVideoURL: URL? nil State private var videoName: String 未選擇視頻 State private var isConverting: Bool false State private var conversionProgress: Double 0.0 State private var statusMessage: String 準(zhǔn)備就緒 var body: some View { VStack(spacing: 30) { Image(systemName: livephoto) .font(.system(size: 80)) .foregroundColor(.blue) .padding(.top, 50) Text(視頻轉(zhuǎn) Live Photo) .font(.largeTitle) .fontWeight(.bold) // 視頻選擇區(qū)域 VStack { PhotosPicker( selection: $selectedVideo, matching: .videos, // 只允許選擇視頻 photoLibrary: .shared() ) { Label(選擇 MP4 視頻, systemImage: video.fill) .frame(maxWidth: .infinity) .padding() .background(Color.blue) .foregroundColor(.white) .cornerRadius(10) } .onChange(of: selectedVideo) { newItem in Task { // 當(dāng)用戶選擇視頻后加載其 URL if let loadedURL try? await newItem?.loadTransferable(type: URL.self) { selectedVideoURL loadedURL videoName loadedURL.lastPathComponent statusMessage 已選擇: \(videoName) } else { statusMessage 視頻加載失敗 } } } Text(videoName) .font(.caption) .foregroundColor(.gray) .lineLimit(1) } .padding(.horizontal) // 進(jìn)度條 ProgressView(value: conversionProgress, total: 1.0) { Text(isConverting ? 轉(zhuǎn)換中... : 等待轉(zhuǎn)換) } .progressViewStyle(.linear) .padding(.horizontal) .opacity(isConverting ? 1.0 : 0.5) // 轉(zhuǎn)換時(shí)才高亮 // 轉(zhuǎn)換按鈕 Button(action: { convertVideoToLivePhoto() }) { Text(開始轉(zhuǎn)換) .frame(maxWidth: .infinity) .padding() .background(selectedVideoURL ! nil ? Color.green : Color.gray) .foregroundColor(.white) .cornerRadius(10) } .disabled(selectedVideoURL nil || isConverting) // 未選擇視頻或轉(zhuǎn)換中時(shí)禁用 .padding(.horizontal) // 狀態(tài)信息 Text(statusMessage) .font(.body) .foregroundColor(.secondary) .multilineTextAlignment(.center) .padding() Spacer() Text(提示生成的 Live Photo 將保存到系統(tǒng)相冊) .font(.footnote) .foregroundColor(.orange) .padding(.bottom) } .padding() } // 轉(zhuǎn)換函數(shù) - 核心邏輯將在下一步實(shí)現(xiàn) private func convertVideoToLivePhoto() { guard let videoURL selectedVideoURL else { return } statusMessage 開始處理視頻... isConverting true conversionProgress 0.1 // TODO: 在這里調(diào)用視頻處理函數(shù) // 為了演示我們模擬一個(gè)處理過程 DispatchQueue.main.asyncAfter(deadline: .now() 2.0) { conversionProgress 1.0 statusMessage 轉(zhuǎn)換完成請到相冊查看。 isConverting false // 實(shí)際完成后需要重置進(jìn)度 DispatchQueue.main.asyncAfter(deadline: .now() 1.5) { conversionProgress 0.0 } } } } #Preview { ContentView() }代碼解釋使用了 SwiftUI 的PhotosPicker來訪問用戶相冊選擇視頻。State屬性包裝器用于管理視圖狀態(tài)。onChange修飾器監(jiān)聽視頻選擇事件并異步加載視頻的 URL。轉(zhuǎn)換按鈕在未選擇視頻或正在轉(zhuǎn)換時(shí)會被禁用。convertVideoToLivePhoto函數(shù)目前是模擬的我們將在后續(xù)步驟填充真實(shí)邏輯。5.2 模塊二視頻處理核心類我們需要創(chuàng)建一個(gè)專門處理視頻的類。在 Xcode 中新建一個(gè) Swift 文件File-New-File...選擇 “Swift File”命名為LivePhotoConverter.swift。這個(gè)類將包含所有核心功能提取視頻片段、抓取封面圖、生成配對文件。這部分涉及AVFoundation框架如果你不熟悉可以嘗試向 Codex 提問“用 Swift 和 AVFoundation 從視頻 URL 截取中間一幀作為 UIImage” 或 “用 AVFoundation 裁剪視頻的前3秒”。以下是完整的LivePhotoConverter.swift代碼// 文件LivePhotoConverter.swift import Foundation import AVFoundation import UIKit import Photos class LivePhotoConverter { // 錯(cuò)誤枚舉 enum ConverterError: Error { case invalidVideoURL case assetLoadFailed case videoTrackNotFound case failedToExportVideo case failedToGenerateImage case failedToSaveToPhotoLibrary case livePhotoCreationFailed } /// 將視頻轉(zhuǎn)換為 Live Photo 并保存到相冊 /// - Parameters: /// - sourceVideoURL: 源視頻文件的本地 URL /// - progressHandler: 進(jìn)度回調(diào) (0.0 - 1.0) /// - completion: 完成回調(diào)返回成功或錯(cuò)誤 static func convertToLivePhoto( from sourceVideoURL: URL, progressHandler: escaping (Double) - Void, completion: escaping (ResultVoid, Error) - Void ) { // 1. 準(zhǔn)備工作定義輸出路徑 let fileManager FileManager.default let tempDirectory fileManager.temporaryDirectory let outputVideoURL tempDirectory.appendingPathComponent(livephoto_video.mov) let outputImageURL tempDirectory.appendingPathComponent(livephoto_image.jpg) // 清理可能存在的舊文件 try? fileManager.removeItem(at: outputVideoURL) try? fileManager.removeItem(at: outputImageURL) // 2. 異步處理避免阻塞主線程 DispatchQueue.global(qos: .userInitiated).async { do { progressHandler(0.1) // 3. 裁剪視頻為3秒Live Photo標(biāo)準(zhǔn)長度 let croppedVideoURL try cropVideo(sourceVideoURL, toDuration: 3.0, outputURL: outputVideoURL) progressHandler(0.4) // 4. 從裁剪后的視頻中提取封面圖這里模擬image2的“智能選幀”取中間幀 let coverImageURL try extractCoverImage(from: croppedVideoURL, outputURL: outputImageURL) progressHandler(0.7) // 5. 將視頻和圖片配對成Live Photo并保存到相冊 try savePairedFilesAsLivePhoto(videoURL: croppedVideoURL, imageURL: coverImageURL) progressHandler(1.0) // 6. 清理臨時(shí)文件可選但建議 try? fileManager.removeItem(at: croppedVideoURL) try? fileManager.removeItem(at: coverImageURL) DispatchQueue.main.async { completion(.success(())) } } catch { // 清理臨時(shí)文件 try? fileManager.removeItem(at: outputVideoURL) try? fileManager.removeItem(at: outputImageURL) DispatchQueue.main.async { completion(.failure(error)) } } } } // MARK: - 私有方法 /// 裁剪視頻到指定時(shí)長 private static func cropVideo(_ inputURL: URL, toDuration duration: TimeInterval, outputURL: URL) throws - URL { let asset AVAsset(url: inputURL) // 創(chuàng)建導(dǎo)出會話 guard let exportSession AVAssetExportSession(asset: asset, presetName: AVAssetExportPresetHighestQuality) else { throw ConverterError.failedToExportVideo } // 設(shè)置輸出文件類型 exportSession.outputURL outputURL exportSession.outputFileType .mov // Live Photo 要求視頻為 .mov 格式 exportSession.shouldOptimizeForNetworkUse true // 計(jì)算裁剪時(shí)間范圍取視頻的前duration秒如果視頻更短則取全部 let videoDuration CMTimeGetSeconds(asset.duration) let cropDuration min(duration, videoDuration) let startTime CMTime(seconds: 0, preferredTimescale: 600) let endTime CMTime(seconds: cropDuration, preferredTimescale: 600) let timeRange CMTimeRangeFromTimeToTime(start: startTime, end: endTime) exportSession.timeRange timeRange // 異步導(dǎo)出 let semaphore DispatchSemaphore(value: 0) var exportError: Error? exportSession.exportAsynchronously { switch exportSession.status { case .completed: break // 成功 case .failed, .cancelled: exportError exportSession.error ?? ConverterError.failedToExportVideo default: break } semaphore.signal() } // 等待導(dǎo)出完成 _ semaphore.wait(timeout: .distantFuture) if let error exportError { throw error } guard fileManager.fileExists(atPath: outputURL.path) else { throw ConverterError.failedToExportVideo } return outputURL } /// 從視頻中提取封面圖取中間幀 private static func extractCoverImage(from videoURL: URL, outputURL: URL) throws - URL { let asset AVAsset(url: videoURL) let duration CMTimeGetSeconds(asset.duration) // 取視頻中間時(shí)刻 let middleTime CMTime(seconds: duration / 2.0, preferredTimescale: 600) // 創(chuàng)建圖像生成器 let imageGenerator AVAssetImageGenerator(asset: asset) imageGenerator.appliesPreferredTrackTransform true // 應(yīng)用視頻方向變換 imageGenerator.requestedTimeToleranceBefore .zero imageGenerator.requestedTimeToleranceAfter .zero // 精確抓取 var actualTime CMTime.zero var cgImage: CGImage? do { cgImage try imageGenerator.copyCGImage(at: middleTime, actualTime: actualTime) } catch { throw ConverterError.failedToGenerateImage } guard let cgImage cgImage else { throw ConverterError.failedToGenerateImage } // 將 CGImage 轉(zhuǎn)換為 UIImage 并保存為 JPEG let uiImage UIImage(cgImage: cgImage) guard let jpegData uiImage.jpegData(compressionQuality: 0.9) else { throw ConverterError.failedToGenerateImage } do { try jpegData.write(to: outputURL) return outputURL } catch { throw ConverterError.failedToGenerateImage } } /// 將視頻和圖片文件作為 Live Photo 保存到系統(tǒng)相冊 private static func savePairedFilesAsLivePhoto(videoURL: URL, imageURL: URL) throws { // 這是一個(gè)異步操作我們使用信號量將其轉(zhuǎn)換為同步為了簡化示例 let semaphore DispatchSemaphore(value: 0) var saveError: Error? PHPhotoLibrary.shared().performChanges({ // 創(chuàng)建 Live Photo 資源請求 let creationRequest PHAssetCreationRequest.forAsset() // 添加視頻資源 let videoOptions PHAssetResourceCreationOptions() videoOptions.shouldMoveFile true // 移動而非復(fù)制節(jié)省空間 creationRequest.addResource(with: .pairedVideo, fileURL: videoURL, options: videoOptions) // 添加圖片資源 let imageOptions PHAssetResourceCreationOptions() imageOptions.shouldMoveFile true creationRequest.addResource(with: .photo, fileURL: imageURL, options: imageOptions) }) { success, error in if !success { saveError error ?? ConverterError.livePhotoCreationFailed } semaphore.signal() } _ semaphore.wait(timeout: .distantFuture) if let error saveError { throw error } } private static var fileManager: FileManager { return FileManager.default } }關(guān)鍵點(diǎn)解析錯(cuò)誤處理定義了詳細(xì)的錯(cuò)誤枚舉便于定位問題。異步操作所有耗時(shí)操作導(dǎo)出視頻、保存到相冊都在后臺線程進(jìn)行并通過閉包回調(diào)結(jié)果避免阻塞 UI。視頻裁剪使用AVAssetExportSession將視頻裁剪為前 3 秒Live Photo 標(biāo)準(zhǔn)時(shí)長。presetName: AVAssetExportPresetHighestQuality保證了輸出質(zhì)量。封面圖提取使用AVAssetImageGenerator在視頻的中間時(shí)刻抓取一幀。appliesPreferredTrackTransform確保了圖片方向正確。Live Photo 保存這是最核心的一步。使用PHAssetCreationRequest的addResource(with:fileURL:options:)方法分別添加類型為.pairedVideo和.photo的資源。shouldMoveFile true非常重要它會在保存成功后刪除我們創(chuàng)建的臨時(shí)文件避免占用額外空間。臨時(shí)文件管理所有中間文件都創(chuàng)建在系統(tǒng)的臨時(shí)目錄 (NSTemporaryDirectory()) 中并在處理完成后及時(shí)清理。5.3 模塊三整合與調(diào)用現(xiàn)在我們需要回到ContentView.swift將模擬的convertVideoToLivePhoto函數(shù)替換為真實(shí)的轉(zhuǎn)換邏輯。更新ContentView.swift中的convertVideoToLivePhoto函數(shù)private func convertVideoToLivePhoto() { guard let videoURL selectedVideoURL else { statusMessage 錯(cuò)誤未選擇視頻 return } statusMessage 開始處理視頻... isConverting true conversionProgress 0.0 LivePhotoConverter.convertToLivePhoto(from: videoURL) { progress in // 更新進(jìn)度條在主線程 DispatchQueue.main.async { self.conversionProgress progress self.statusMessage String(format: 處理中... %.0f%%, progress * 100) } } completion: { result in // 處理完成在主線程 DispatchQueue.main.async { self.isConverting false switch result { case .success(): self.statusMessage 轉(zhuǎn)換成功Live Photo 已保存到系統(tǒng)相冊。 self.conversionProgress 0.0 // 成功后可重置選擇 self.selectedVideo nil self.selectedVideoURL nil self.videoName 未選擇視頻 case .failure(let error): self.statusMessage 轉(zhuǎn)換失敗: \(error.localizedDescription) self.conversionProgress 0.0 } } } }6. 運(yùn)行結(jié)果與效果驗(yàn)證代碼已經(jīng)完成讓我們運(yùn)行并測試它。6.1 在模擬器中運(yùn)行基礎(chǔ)功能測試在 Xcode 頂部的 Scheme 選擇器中選擇一個(gè) iPhone 模擬器如 iPhone 15 Pro。點(diǎn)擊Cmd R運(yùn)行。應(yīng)用啟動后點(diǎn)擊“選擇 MP4 視頻”按鈕。注意模擬器的相冊可能是空的。你需要先手動拖拽一個(gè).mp4或.mov視頻文件到模擬器窗口中系統(tǒng)會詢問是否保存到照片選擇“保存”。這樣視頻就會出現(xiàn)在模擬器的相冊里。選擇視頻點(diǎn)擊“開始轉(zhuǎn)換”。你會看到進(jìn)度條變化和狀態(tài)更新。重要在模擬器上PHPhotoLibrary.shared().performChanges可能會成功但你無法在模擬器的“照片”App 中看到生成的 Live Photo模擬器對相冊的支持不完整。狀態(tài)提示“轉(zhuǎn)換成功”僅代表代碼流程走到了保存步驟。6.2 在真機(jī)上運(yùn)行完整功能驗(yàn)證這是必須的一步因?yàn)橄鄡詫懭牍δ苄枰谡鏅C(jī)上才能完全驗(yàn)證。連接 iPhone用數(shù)據(jù)線將 iPhone 連接到 Mac。配置簽名在 Xcode 項(xiàng)目導(dǎo)航器中選擇你的項(xiàng)目藍(lán)色圖標(biāo)。選擇Signing Capabilities標(biāo)簽頁。在 “Team” 下拉框中選擇你的 Apple ID 個(gè)人團(tuán)隊(duì)。Xcode 會自動為你創(chuàng)建臨時(shí)的開發(fā)證書和配置文件。選擇真機(jī)設(shè)備在 Scheme 選擇器中選擇你連接的 iPhone。信任開發(fā)者首次在真機(jī)上運(yùn)行自簽名的 App 時(shí)需要去 iPhone 的設(shè)置-通用-VPN與設(shè)備管理或設(shè)備管理找到你的開發(fā)者證書點(diǎn)擊“信任”。運(yùn)行點(diǎn)擊Cmd R。Xcode 會將應(yīng)用安裝到你的 iPhone 上。授予權(quán)限首次點(diǎn)擊“選擇 MP4 視頻”時(shí)系統(tǒng)會彈出權(quán)限請求選擇“允許訪問所有照片”或“選中的照片”。保存 Live Photo 時(shí)系統(tǒng)會再次彈窗請求“允許‘LivePhotoConverter’添加照片”點(diǎn)擊“允許”。測試流程選擇一個(gè)手機(jī)相冊里的短視頻最好時(shí)長大于3秒。點(diǎn)擊“開始轉(zhuǎn)換”。觀察進(jìn)度條和狀態(tài)。轉(zhuǎn)換成功后打開系統(tǒng)自帶的“照片”App。你應(yīng)該能在“最近項(xiàng)目”或“所有照片”中看到一個(gè)新項(xiàng)目。長按這個(gè)照片它應(yīng)該會動起來并伴有聲音如果原視頻有聲音。這就說明 Live Photo 創(chuàng)建成功了你還可以嘗試將其設(shè)置為鎖屏壁紙?bào)w驗(yàn)動態(tài)效果。7. 常見問題與排查思路在實(shí)際開發(fā)和使用中你幾乎一定會遇到下面這些問題。這里提供了詳細(xì)的排查指南。問題現(xiàn)象可能原因排查方式解決方案編譯錯(cuò)誤Cannot find ‘PhotosPicker’ in scope項(xiàng)目目標(biāo)版本低于 iOS 16。PhotosPicker是 iOS 16 的 API。檢查 Xcode 中項(xiàng)目的Deployment Target。將Target-General-Minimum Deployments設(shè)置為iOS 16.0或更高?;蛘呤褂门f的UIImagePickerController替代。真機(jī)運(yùn)行時(shí)點(diǎn)擊選擇視頻按鈕無反應(yīng)或崩潰權(quán)限描述 (Info.plist) 未配置或配置錯(cuò)誤。檢查Info.plist中是否已添加Privacy - Photo Library Usage Description。確保按照4.2章節(jié)正確添加了兩個(gè)權(quán)限描述。描述文本不能為空。轉(zhuǎn)換失敗錯(cuò)誤信息包含NSPhotoLibraryAddUsageDescription缺少“僅添加照片”的權(quán)限。檢查Info.plist。添加Privacy - Photo Library Additions Usage Description鍵值對。轉(zhuǎn)換進(jìn)度卡住長時(shí)間無響應(yīng)1. 視頻文件過大或格式特殊。2.AVAssetExportSession導(dǎo)出失敗但未觸發(fā)錯(cuò)誤回調(diào)。3. 主線程被阻塞。1. 查看控制臺 (Console.app) 有無 AVFoundation 相關(guān)日志。2. 在cropVideo和extractCoverImage函數(shù)開始和結(jié)束處添加print語句。3. 檢查是否在后臺線程執(zhí)行耗時(shí)操作。1. 嘗試換一個(gè)小的、標(biāo)準(zhǔn)的 MP4 視頻測試。2. 為exportSession設(shè)置timeout處理或檢查exportSession.status和error屬性。3. 確保所有文件 IO 和媒體處理都在DispatchQueue.global中。轉(zhuǎn)換成功但相冊里看不到 Live Photo或看到的是兩個(gè)獨(dú)立文件一個(gè)視頻一個(gè)圖片1. 保存 Live Photo 的 API 調(diào)用失敗。2. 視頻和圖片文件格式或元數(shù)據(jù)不符合要求。3.僅在模擬器上出現(xiàn)模擬器相冊功能不完整。1. 檢查PHPhotoLibrary.shared().performChanges的完成回調(diào)success是否為falseerror是什么。2. 確保視頻輸出格式為.mov。3.在真機(jī)上測試。1. 根據(jù)錯(cuò)誤信息調(diào)整代碼。2. 確保使用PHAssetResourceCreationOptions()并設(shè)置shouldMoveFile true。3.務(wù)必在真機(jī)上進(jìn)行最終功能驗(yàn)證。生成的 Live Photo 沒有聲音AVAssetExportSession的預(yù)設(shè)可能丟失了音頻軌道。檢查源視頻是否有音頻軌道檢查導(dǎo)出配置。確保AVAssetExportSession的presetName是包含音頻的如AVAssetExportPresetHighestQuality??梢燥@式檢查asset.tracks(withMediaType: .audio)。封面圖模糊或方向不對1.AVAssetImageGenerator未設(shè)置appliesPreferredTrackTransform。2. 壓縮質(zhì)量太低。檢查extractCoverImage方法中的生成器配置。1. 確保imageGenerator.appliesPreferredTrackTransform true。2. 調(diào)整jpegData(compressionQuality:)的參數(shù)例如提高到0.95。Codex/Copilot 生成的代碼有語法錯(cuò)誤或使用了過時(shí) APIAI 模型基于舊代碼訓(xùn)練或上下文理解有偏差。仔細(xì)閱讀 Xcode 的錯(cuò)誤提示和警告。1. 將錯(cuò)誤信息反饋給 AI讓它修正。2. 自己查閱蘋果官方文檔 (developer.apple.com/documentation)。3. 利用 Xcode 的 Fix-it 建議。8. 最佳實(shí)踐與工程建議將這個(gè) demo 升級為一個(gè)健壯的、可發(fā)布的 App你還需要考慮以下幾點(diǎn)8.1 性能優(yōu)化內(nèi)存管理處理高清視頻時(shí)AVAsset和AVAssetExportSession會占用大量內(nèi)存。確保在后臺線程操作并在使用后及時(shí)釋放資源。對于大視頻可以考慮分片處理。磁盤空間使用shouldMoveFile true來移動而非復(fù)制臨時(shí)文件。處理完成后務(wù)必清理所有臨時(shí)文件 (FileManager.default.removeItem)。用戶體驗(yàn)在轉(zhuǎn)換過程中禁用相關(guān) UI 控件并提供取消操作的功能。可以通過保存exportSession的引用來實(shí)現(xiàn)取消。8.2 錯(cuò)誤處理與用戶體驗(yàn)更友好的錯(cuò)誤提示將ConverterError轉(zhuǎn)換為用戶能看懂的文字而不是直接顯示localizedDescription。網(wǎng)絡(luò)視頻支持當(dāng)前僅支持本地相冊視頻??梢钥紤]支持從 iCloud 或網(wǎng)絡(luò) URL 下載視頻但這需要處理下載過程和額外的錯(cuò)誤如網(wǎng)絡(luò)中斷。格式兼容性除了 MP4測試 MOV、AVI 等格式。使用AVURLAsset的compatibleTrack進(jìn)行檢查對不支持的格式給出明確提示。8.3 擴(kuò)展 image2 的“智能”能力本文只是簡單截取中間幀。真正的“智能選幀”可以使用 Vision 框架利用 iOS 自帶的VNDetectFaceRectanglesRequest或VNDetectRectanglesRequest來識別人臉或主體確保封面圖不截到黑屏或無關(guān)背景。多幀評分每隔 0.1 秒取一幀計(jì)算其清晰度例如拉普拉斯方差、亮度、對比度選擇綜合評分最高的一幀。服務(wù)端處理如果視頻處理非常耗時(shí)可以將視頻上傳到服務(wù)器利用更強(qiáng)大的 image2 類模型進(jìn)行分析將最佳幀的時(shí)間點(diǎn)返回給 App。但這需要網(wǎng)絡(luò)和后端支持。8.4 上架 App Store 注意事項(xiàng)加入 Apple Developer Program支付年費(fèi)。完善 App 元數(shù)據(jù)圖標(biāo)、截圖、描述、關(guān)鍵詞、隱私政策鏈接。處理 App Store 審核指南功能明確說明 App 的核心功能是視頻轉(zhuǎn) Live Photo。不要誤導(dǎo)確保生成的是真正的 Live Photo而不是偽動態(tài)圖。隱私在Info.plist中準(zhǔn)確聲明照片庫權(quán)限并考慮在 App 內(nèi)再次解釋為何需要此權(quán)限。版權(quán)在用戶協(xié)議中聲明用戶應(yīng)僅轉(zhuǎn)換其擁有版權(quán)的視頻。測試在各種型號、系統(tǒng)版本的 iPhone 和 iPad 上進(jìn)行充分測試。9. 總結(jié)與后續(xù)學(xué)習(xí)方向通過這個(gè)項(xiàng)目我們完成了一次從設(shè)計(jì)到實(shí)現(xiàn)的完整旅程。你不僅得到了一個(gè)可用的工具更重要的是掌握了一套方法問題拆解將“視頻轉(zhuǎn) Live Photo”這個(gè)模糊需求拆解為文件讀取、視頻裁剪、圖像抓取、相冊寫入等具體技術(shù)任務(wù)。AI 輔助開發(fā)合理利用 Codex/Copilot 等工具生成樣板代碼、解釋復(fù)雜 API將你的精力集中在核心業(yè)務(wù)邏輯和架構(gòu)設(shè)計(jì)上。框架深度使用深入使用了AVFoundation媒體處理和Photos相冊交互這兩個(gè) iOS 核心框架了解了關(guān)鍵類如AVAssetExportSession,AVAssetImageGenerator,PHAssetCreationRequest的用法。工程化思維考慮了錯(cuò)誤處理、異步編程、內(nèi)存管理、臨時(shí)文件清理、權(quán)限申請和用戶體驗(yàn)。下一步你可以做什么美化 UI使用更精美的 SwiftUI 組件添加視頻預(yù)覽、封面圖預(yù)覽功能。增加高級功能讓用戶手動選擇視頻片段范圍、自定義封面圖、調(diào)節(jié) Live Photo 的靜音/有聲狀態(tài)、批量轉(zhuǎn)換。探索 Core ML將簡單的中間幀選取替換為使用 Core ML 運(yùn)行一個(gè)輕量級圖像質(zhì)量評估模型實(shí)現(xiàn)真正的“智能選幀”??缙脚_思考這個(gè)想法在 Android 上如何實(shí)現(xiàn)Android 有類似 Live Photo 的“動態(tài)照片”嗎產(chǎn)品化如果你對這個(gè)工具感興趣可以按照8.4的指南完善它并嘗試上架 App Store看看用戶的反饋。開發(fā)的過程就是不斷將想法拆解、搜索、學(xué)習(xí)、實(shí)驗(yàn)和整合的過程。這個(gè)項(xiàng)目是一個(gè)完美的起點(diǎn)。希望你能在此基礎(chǔ)上創(chuàng)造出更棒的作品。建議收藏本文在遇到類似的多媒體處理需求時(shí)可以回來參考這里的實(shí)現(xiàn)思路和避坑指南。