之前做 iOS 拍攝類功能時我一直在吐槽 iPhone 原生相機在逆光場景下的體驗明明陽光很好取景器里卻黑成一片點一下亮處對焦整體畫面又過曝得厲害。后來在 Hacker News 上看到一個很有意思的項目叫 “Camera Sun”定位就是針對 iPhone 相機 App 的取景與曝光問題進行改進。這讓我意識到單純吐槽原生相機不夠用不如自己動手在 AVFoundation 層面做一套自定義相機方案把取景亮度分析、曝光補償、手動輔助控件這些能力補全。本文將圍繞這個思路完整拆解一個名為Camera Sun的 iOS 自定義相機項目。先從原生相機的問題場景入手再講清楚 AVFoundation 的采集架構然后給出完整可運行的 SwiftUI AVFoundation 案例代碼最后補充常見報錯排查和工程化建議。無論你是 iOS 新手還是在做自定義相機、掃碼、AR 采集的開發者都可以從中找到可以復用的內容。1. 背景iPhone 原生相機在逆光場景下為什么“不好用”1.1 原生相機的“自動”與“不夠自動”iPhone 自帶相機 App 的拍攝體驗在大多數日常場景下是非常優秀的白平衡、自動曝光、智能 HDR 都做得足夠好。但一旦進入逆光、大光比、強太陽直射這類環境問題就很容易暴露出來取景器畫面偏暗主體輪廓不清晰。點擊暗部對焦亮部直接過曝。點擊亮部對焦暗部又死黑一片。自動曝光系統始終在“你想拍什么”和“天空很亮”之間搖擺。這本質上不是相機硬件不行而是原生相機的自動曝光策略更偏向“整體畫面均衡”在生產級拍攝中我們經常需要的是“對某個區域精準曝光”甚至需要手動干預 EV 補償值。1.2 “Camera Sun”項目想解決的問題“Camera Sun”這個名字很直白——它面向的是“太陽”這種極端光源場景。項目的核心目標是把取景器中的畫面亮度信息用更直觀的方式呈現出來。提供手動曝光補償EV控制。在強光或者逆光環境下幫助用戶先看清畫面再按下快門。用自定義相機方案替代原生相機在某些場景下的不足。放到開發層面它背后的技術點其實就是幾個用 AVFoundation 自定義相機采集流程。實時獲取每一幀畫面的亮度數據。根據亮度分析結果調整曝光參數。在取景界面上疊加輔助控件比如亮度條、點測光框、EV 滑塊。本文的實戰項目會圍繞這四點展開做一個能用模擬器跑通、可以在真機上體驗的 Mini 版本。2. 環境準備與項目結構2.1 開發環境說明本文示例以常見環境為例版本需要根據你的項目實際情況調整項目說明操作系統macOS 12 及以上IDEXcode 14 及以上語言Swift 5.7UI 框架SwiftUI系統框架AVFoundation、CoreImage、UIKit最低部署版本iOS 15.0調試設備建議使用 iPhone 真機需要特別說明的是相機類功能在模擬器中會有很大限制尤其是采集會話、曝光參數調整、亮度回調這些能力模擬器只能模擬部分行為。所以本文的代碼在模擬器上可以運行界面但完整功能建議在真機上驗證。2.2 項目基礎結構我們先在 Xcode 中創建一個 SwiftUI App 項目工程名稱可以叫CameraSunDemo最終文件結構如下CameraSunDemo/ ├── CameraSunDemoApp.swift ├── ContentView.swift ├── Models/ │ └── ExposureState.swift ├── Services/ │ └── CameraService.swift ├── Views/ │ ├── CameraPreviewView.swift │ ├── BrightnessIndicatorView.swift │ └── ExposureControlView.swift └── Info.plist后面所有代碼都會按照這個結構給出文件路徑方便你對照創建。3. 核心原理AVFoundation 相機采集鏈路3.1 從 AVCaptureSession 說起在 iOS 中實現自定義相機核心類是AVCaptureSession。它就像一條“數據管道”把相機硬件采集到的數據經過輸入、輸出兩個端口連接起來。相機硬件 ↓ AVCaptureDeviceInput輸入 ↓ AVCaptureSession會話 ↓ AVCaptureVideoDataOutput輸出回調 ↓ CMSampleBuffer單幀數據與直接調用UIImagePickerController相比使用 AVFoundation 自定義采集可以獲得對每一幀畫面做實時處理的能力。手動控制曝光、對焦、白平衡的權限。更自由的界面定制。更低的延遲。3.2 曝光補償 EV 是什么曝光補償用 EVExposure Value表示單位為 eV簡單理解就是“在你測光結果的基礎上人為地讓畫面更亮或更暗一檔”。iPhone 相機的 AVFoundation 提供了非常直接的控制接口device.setExposureTargetBias(completionHandler:)AVCaptureDevice上的exposureTargetBias屬性可以設置當前曝光補償值范圍通常在minExposureTargetBias到maxExposureTargetBias之間iPhone 一般支持-8.0到8.0實際會根據設備能力有所差異。3.3 實時亮度分析思路在自定義相機中要判斷當前畫面是不是“太黑”或“太亮”最直接的方法是讀取每一幀畫面的平均亮度。常用的實現路徑是AVCaptureVideoDataOutput輸出CMSampleBuffer。將CMSampleBuffer轉成CVPixelBuffer。使用 CoreImage 的CIAreaAverage濾鏡計算平均顏色。將平均顏色的亮度值映射到 UI 上。具體代碼如下func brightness(from pixelBuffer: CVPixelBuffer) - Float? { let ciImage CIImage(cvPixelBuffer: pixelBuffer) let extent ciImage.extent let filter CIFilter(name: CIAreaAverage)! filter.setValue(ciImage, forKey: kCIInputImageKey) filter.setValue(CIVector(cgRect: extent), forKey: kCIInputExtentKey) guard let outputImage filter.outputImage else { return nil } var bitmap [UInt8](repeating: 0, count: 4) let context CIContext(options: [.workingColorSpace: NSNull()]) context.render(outputImage, toBitmap: bitmap, rowBytes: 4, bounds: CGRect(x: 0, y: 0, width: 1, height: 1), format: .RGBA8, colorSpace: nil) let r Float(bitmap[0]) / 255.0 let g Float(bitmap[1]) / 255.0 let b Float(bitmap[2]) / 255.0 // 使用 Rec.709 亮度權重 let brightness 0.2126 * r 0.7152 * g 0.0722 * b return brightness }這里使用CIAreaAverage的原因是它由 CoreImage 底層優化性能比自己遍歷像素要好很多。需要注意的點是CIContext建議復用不要每幀創建。CIAreaAverage的運行耗時取決于圖像大小實際項目建議先縮小圖像再計算。3.4 AVCaptureVideoDataOutput 的像素格式設置要讓上面的亮度計算代碼正常工作需要確保輸出像素格式是 BGRA 或者 RGBA。在創建AVCaptureVideoDataOutput時建議顯式設置videoOutput.videoSettings [ kCVPixelBufferPixelFormatTypeKey as String: kCVPixelFormatType_32BGRA ]如果你不設置系統默認可能輸出 420f也就是kCVPixelFormatType_420YpCbCr8BiPlanarVideoRange這時候直接轉CIImage再走CIAreaAverage也可以但輸出顏色通道需要額外處理不夠直觀。所以我們統一改成 BGRA方便調試。4. 完整實戰實現 Camera Sun 的取景亮度分析與曝光控制下面我們進入核心實戰環節。這一節會逐步完成一個 Mini 版 Camera Sun功能包括啟動自定義相機并顯示實時預覽。分析每一幀畫面的平均亮度。用一個可視化的亮度條展示當前亮度狀態。通過滑塊手動調節曝光補償 EV 值。點擊預覽畫面進行點測光對焦。4.1 創建相機服務類先創建相機采集服務類CameraService它負責整個 AVCaptureSession 的生命周期。文件路徑Services/CameraService.swiftimport AVFoundation import CoreImage import UIKit protocol CameraServiceDelegate: AnyObject { func cameraService(_ service: CameraService, didOutput brightness: Float) func cameraService(_ service: CameraService, didFail error: Error) } final class CameraService: NSObject { private let session AVCaptureSession() private let sessionQueue DispatchQueue(label: com.camerasun.sessionQueue) private let videoOutput AVCaptureVideoDataOutput() private let ciContext CIContext(options: [.workingColorSpace: NSNull()]) private var currentDevice: AVCaptureDevice? weak var delegate: CameraServiceDelegate? var previewLayer: AVCaptureVideoPreviewLayer { let layer AVCaptureVideoPreviewLayer(session: session) layer.videoGravity .resizeAspectFill return layer } override init() { super.init() videoOutput.setSampleBufferDelegate(self, queue: DispatchQueue(label: com.camerasun.videoQueue)) videoOutput.alwaysDiscardsLateVideoFrames true videoOutput.videoSettings [ kCVPixelBufferPixelFormatTypeKey as String: kCVPixelFormatType_32BGRA ] } func start() { sessionQueue.async { [weak self] in self?.configureSession() self?.session.startRunning() } } func stop() { sessionQueue.async { [weak self] in self?.session.stopRunning() } } private func configureSession() { session.beginConfiguration() session.sessionPreset .high guard let device AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back) else { delegate?.cameraService(self, didFail: CameraError.deviceNotFound) return } currentDevice device do { let input try AVCaptureDeviceInput(device: device) if session.canAddInput(input) { session.addInput(input) } } catch { delegate?.cameraService(self, didFail: error) return } if session.canAddOutput(videoOutput) { session.addOutput(videoOutput) } session.commitConfiguration() } func setExposureBias(_ value: Float) { guard let device currentDevice else { return } do { try device.lockForConfiguration() let clampedValue max(device.minExposureTargetBias, min(device.maxExposureTargetBias, value)) device.setExposureTargetBias(clampedValue) { _ in } device.unlockForConfiguration() } catch { print(鎖定設備配置失敗: \(error)) } } func focusAtPoint(_ point: CGPoint, in previewLayer: AVCaptureVideoPreviewLayer) { guard let device currentDevice else { return } let pointOfInterest previewLayer.captureDevicePointConverted(fromLayerPoint: point) do { try device.lockForConfiguration() if device.isFocusPointOfInterestSupported { device.focusPointOfInterest pointOfInterest device.focusMode .autoFocus } if device.isExposurePointOfInterestSupported { device.exposurePointOfInterest pointOfInterest device.exposureMode .autoExpose } device.unlockForConfiguration() } catch { print(設置對焦失敗: \(error)) } } } extension CameraService: AVCaptureVideoDataOutputSampleBufferDelegate { func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) { guard let pixelBuffer CMSampleBufferGetImageBuffer(sampleBuffer) else { return } if let brightness brightness(from: pixelBuffer) { DispatchQueue.main.async { [weak self] in self?.delegate?.cameraService(self!, didOutput: brightness) } } } private func brightness(from pixelBuffer: CVPixelBuffer) - Float? { let ciImage CIImage(cvPixelBuffer: pixelBuffer) let extent ciImage.extent let filter CIFilter(name: CIAreaAverage)! filter.setValue(ciImage, forKey: kCIInputImageKey) filter.setValue(CIVector(cgRect: extent), forKey: kCIInputExtentKey) guard let outputImage filter.outputImage else { return nil } var bitmap [UInt8](repeating: 0, count: 4) ciContext.render(outputImage, toBitmap: bitmap, rowBytes: 4, bounds: CGRect(x: 0, y: 0, width: 1, height: 1), format: .RGBA8, colorSpace: nil) let r Float(bitmap[0]) / 255.0 let g Float(bitmap[1]) / 255.0 let b Float(bitmap[2]) / 255.0 return 0.2126 * r 0.7152 * g 0.0722 * b } } enum CameraError: LocalizedError { case deviceNotFound var errorDescription: String? { switch self { case .deviceNotFound: return 未找到可用的相機設備 } } }代碼說明使用sessionQueue串行隊列執行會話配置和啟停操作避免主線程阻塞。videoOutput.alwaysDiscardsLateVideoFrames true表示幀數據堆積時丟棄舊幀保證亮度回調的實時性。亮度計算使用 Rec.709 權重更接近人類對亮度的感知。setExposureBias方法會先做min/max范圍約束防止傳入非法值導致崩潰。4.2 創建預覽視圖在 SwiftUI 中接入AVCaptureVideoPreviewLayer最通用的方式是使用UIViewRepresentable包裝一個UIView。文件路徑Views/CameraPreviewView.swiftimport SwiftUI import AVFoundation struct CameraPreviewView: UIViewRepresentable { let previewLayer: AVCaptureVideoPreviewLayer func makeUIView(context: Context) - UIView { let view UIView() view.backgroundColor .black previewLayer.frame view.bounds view.layer.addSublayer(previewLayer) return view } func updateUIView(_ uiView: UIView, context: Context) { DispatchQueue.main.async { previewLayer.frame uiView.bounds } } }這里有一個容易忽略的細節makeUIView執行時UIView的 bounds 可能還不是最終尺寸所以需要在updateUIView中持續更新previewLayer.frame否則預覽畫面可能顯示不全。4.3 創建亮度指示器亮度指示器是 Camera Sun 項目最有辨識度的 UI 之一。它用一條橫向的漸變條展示當前畫面的平均亮度用戶一眼就能看出“現在畫面是偏暗還是偏亮”。文件路徑Views/BrightnessIndicatorView.swiftimport SwiftUI struct BrightnessIndicatorView: View { let brightness: Float let targetBrightness: Float private var normalizedValue: CGFloat { CGFloat(max(0, min(1, brightness))) } var body: some View { GeometryReader { geometry in ZStack(alignment: .leading) { Capsule() .fill(Color.black.opacity(0.6)) .overlay( Capsule() .stroke(Color.white.opacity(0.3), lineWidth: 1) ) // 亮度漸變條 Capsule() .fill( LinearGradient( colors: [.black, .gray, .white], startPoint: .leading, endPoint: .trailing ) ) .frame(width: geometry.size.width * normalizedValue) // 目標亮度指示線 Rectangle() .fill(Color.yellow) .frame(width: 2) .offset(x: geometry.size.width * CGFloat(targetBrightness) - 1) } } .frame(height: 8) } } struct BrightnessIndicatorView_Previews: PreviewProvider { static var previews: some View { BrightnessIndicatorView(brightness: 0.5, targetBrightness: 0.6) .padding() } }這里的targetBrightness可以理解為我們“期望的畫面亮度”比如 0.5 代表中等亮度。當指示條超過目標線時畫面偏亮低于目標線時畫面偏暗。4.4 創建曝光控制滑塊曝光補償是 Camera Sun 的核心交互這里用 SwiftUI 的Slider綁定 EV 值。文件路徑Views/ExposureControlView.swiftimport SwiftUI struct ExposureControlView: View { Binding var exposureValue: Double let range: ClosedRangeDouble var body: some View { VStack(spacing: 8) { HStack { Text(EV) .font(.caption) .foregroundColor(.white) Slider(value: $exposureValue, in: range, step: 0.1) .tint(.yellow) Text(String(format: %.1f, exposureValue)) .font(.caption.monospacedDigit()) .foregroundColor(.white) .frame(width: 50, alignment: .trailing) } HStack { Text(暗) .font(.caption2) .foregroundColor(.white.opacity(0.6)) Spacer() Text(亮) .font(.caption2) .foregroundColor(.white.opacity(0.6)) } } .padding(.horizontal, 16) .padding(.vertical, 12) .background(Color.black.opacity(0.5)) .clipShape(RoundedRectangle(cornerRadius: 12)) .padding(.horizontal, 20) } }4.5 組裝主界面現在把相機預覽、亮度指示器、曝光控制整合到一個界面中。文件路徑Views/ContentView.swiftimport SwiftUI import AVFoundation struct ContentView: View { StateObject private var viewModel CameraViewModel() var body: some View { ZStack { Color.black.ignoresSafeArea() if let previewLayer viewModel.previewLayer { CameraPreviewView(previewLayer: previewLayer) .ignoresSafeArea() } else { ProgressView(相機初始化中...) .foregroundColor(.white) } VStack { Spacer() // 亮度狀態卡片 VStack(alignment: .leading, spacing: 8) { HStack { Image(systemName: sun.max.fill) .foregroundColor(.yellow) Text(亮度分析) .font(.headline) .foregroundColor(.white) Spacer() Text(String(format: %.2f, viewModel.currentBrightness)) .font(.system(.body, design: .monospaced)) .foregroundColor(.white) } BrightnessIndicatorView( brightness: viewModel.currentBrightness, targetBrightness: viewModel.targetBrightness ) Text(viewModel.brightnessDescription) .font(.caption) .foregroundColor(.white.opacity(0.8)) } .padding(16) .background(Color.black.opacity(0.5)) .clipShape(RoundedRectangle(cornerRadius: 16)) .padding(.horizontal, 20) ExposureControlView( exposureValue: $viewModel.exposureValue, range: viewModel.exposureRange ) } } .onAppear { viewModel.start() } .onDisappear { viewModel.stop() } .gesture( DragGesture(minimumDistance: 0) .onEnded { value in viewModel.focusAtPoint(value.location) } ) } } final class CameraViewModel: ObservableObject { Published var previewLayer: AVCaptureVideoPreviewLayer? Published var currentBrightness: Float 0 Published var exposureValue: Double 0 Published var targetBrightness: Float 0.55 Published var exposureRange: ClosedRangeDouble -8.0...8.0 Published var brightnessDescription: String 等待數據... private let cameraService CameraService() private var isUpdatingExposure false init() { cameraService.delegate self preparePreviewLayer() } private func preparePreviewLayer() { // 這里延遲獲取 previewLayer確保 session 已經初始化 DispatchQueue.main.async { [weak self] in guard let self self else { return } self.previewLayer self.cameraService.previewLayer } } func start() { cameraService.start() } func stop() { cameraService.stop() } func focusAtPoint(_ point: CGPoint) { guard let previewLayer previewLayer else { return } cameraService.focusAtPoint(point, in: previewLayer) } } extension CameraViewModel: CameraServiceDelegate { func cameraService(_ service: CameraService, didOutput brightness: Float) { DispatchQueue.main.async { self.currentBrightness brightness switch brightness { case ..0.2: self.brightnessDescription 畫面過暗建議增加曝光補償 case 0.2..0.4: self.brightnessDescription 畫面偏暗可適當增加曝光 case 0.4..0.7: self.brightnessDescription 亮度正常無需調整 case 0.7..0.9: self.brightnessDescription 畫面偏亮可適當降低曝光 default: self.brightnessDescription 畫面過亮建議降低曝光補償 } // 如果有手動曝光調整不自動干預 if abs(self.exposureValue) 0.05 { self.autoAdjustExposureIfNeeded(brightness: brightness) } } } func cameraService(_ service: CameraService, didFail error: Error) { DispatchQueue.main.async { self.brightnessDescription 相機錯誤: \(error.localizedDescription) } } private func autoAdjustExposureIfNeeded(brightness: Float) { guard !isUpdatingExposure else { return } isUpdatingExposure true defer { isUpdatingExposure false } let diff targetBrightness - brightness // 只有偏差超過閾值才調整避免頻繁抖動 if abs(diff) 0.1 { let adjustment Double(diff * 2) let newValue max(-8, min(8, exposureValue adjustment)) cameraService.setExposureBias(Float(newValue)) DispatchQueue.main.async { self.exposureValue newValue } } } }代碼說明CameraViewModel作為中間層負責把CameraService的代理回調轉成 SwiftUI 可觀察的Published屬性。exposureValue被用戶手動拖動后自動曝光調整會暫停避免“用戶想調系統又拉回來”的沖突。亮度描述文本使用區間判斷提示用戶當前畫面狀態。4.6 配置權限在Info.plist中加入相機權限描述keyNSCameraUsageDescription/key stringCamera Sun 需要使用相機來分析和調整拍攝畫面/string不加這一條應用啟動相機采集時會直接崩潰。4.7 運行驗證將上述代碼編譯運行到 iPhone 真機上預期效果如下啟動 App 后進入自定義相機預覽頁面。預覽畫面顯示實時取景。頂部亮度指示條根據畫面亮度實時變化。手動拖動 EV 滑塊后畫面亮度發生明顯變化。手指點擊預覽畫面任意位置相機自動對焦并重新測光。在模擬器上運行時預覽畫面可能是黑屏或者顯示模擬器桌面這是因為模擬器沒有真實相機采集能力。建議盡早使用真機調試。5. 常見問題與排查思路5.1 相機權限彈窗沒有彈出問題現象常見原因解決思路啟動后直接崩潰Info.plist 缺少相機權限描述檢查NSCameraUsageDescription權限彈窗彈出后點擊允許仍然黑屏用戶之前選擇了“不允許”需要在系統設置中開啟提示用戶前往系統設置開啟權限模擬器上沒有彈窗模擬器不支持真實相機使用真機調試5.2 預覽畫面黑屏問題現象常見原因解決思路預覽全黑但相機權限已開啟AVCaptureVideoPreviewLayer沒有正確添加到視圖層級檢查previewLayer.frame是否更新預覽區域黑屏但亮度數據有回調previewLayer被釋放使用強引用保存 previewLayer從后臺返回后黑屏未在viewWillAppear重新啟動 session在scenePhase變化時重新startRunning()5.3 亮度數據不刷新如果cameraService(_:didOutput:)一直不回調優先檢查AVCaptureVideoDataOutput是否成功添加到 sessionif session.canAddOutput(videoOutput) { session.addOutput(videoOutput) } else { print(無法添加 videoDataOutput) }另外AVCaptureVideoDataOutput需要強引用不要聲明為局部變量。5.4 EV 滑塊拖動后畫面沒有變化可能原因當前設備isExposureTargetBiasSupported為false。設備沒有成功lockForConfiguration()。EV 值沒有落在minExposureTargetBias...maxExposureTargetBias范圍內。排查代碼print(曝光補償范圍: \(device.minExposureTargetBias) ~ \(device.maxExposureTargetBias)) print(是否支持曝光補償: \(device.isExposureTargetBiasSupported))5.5 性能問題掉幀和發熱每幀都執行CIAreaAverage在真機上通常不會有太大壓力但如果你的項目比較復雜可以考慮以下優化方式降低采樣幀率比如每 3 幀計算一次亮度。縮小計算區域使用CIImage的cropped(to:)只分析畫面中心區域。降低視頻輸出分辨率使用session.sessionPreset .medium。避免在主線程做任何 CoreImage 操作。降低采樣幀率的示例private var frameCount 0 func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) { frameCount 1 guard frameCount % 3 0 else { return } // 亮度計算 }6. 最佳實踐與工程建議6.1 曝光控制的策略選擇Camera Sun 項目里我把曝光控制做成了兩種模式混合用戶不干預時系統根據亮度信息自動調整 EV。用戶手動調整后以用戶設置為準。這種設計的核心思路是不跟用戶搶控制權。原生相機之所以在一些場景下給人“不聽話”的感覺恰恰是因為自動策略太強勢。在自定義相機中我們應該把自動策略看成“默認值”而不是“唯一值”。在實際業務中還可以增加一個“自動/手動”切換開關讓用戶明確知道當前處于哪種模式。6.2 亮度分析的通用性CIAreaAverage計算的是全畫面平均亮度但在很多場景下它并不準確。例如畫面左邊是太陽右邊是陰影平均亮度可能正好落在 0.5。但用戶真正想拍的主體在陰影里需要的是“陰影區域”的亮度數據。更合理的方式是引入區域權重// 只分析畫面中心 60% 區域的亮度 let centerRect CGRect(x: extent.width * 0.2, y: extent.height * 0.2, width: extent.width * 0.6, height: extent.height * 0.6) let centerImage ciImage.cropped(to: centerRect)這樣在逆光場景下自動曝光會更偏向畫面中心的主體。6.3 設備配置的邊界檢查AVFoundation 的 API 在不同 iOS 版本、不同設備上有很大差異。比如某些設備支持builtInDualCamera某些只有builtInWideAngleCamera。不同設備的minExposureTargetBias和maxExposureTargetBias范圍不同。某些設備支持autoFocusRangeRestriction某些不支持。所以在做設備配置時一定要先查詢能力再設置屬性if device.isExposurePointOfInterestSupported { device.exposurePointOfInterest point }6.4 線程模型的必要性在CameraService中我使用了三個隊列sessionQueue配置會話、啟停相機。videoQueue接收視頻幀回調。主隊列更新 UI。原因是相機配置操作耗時且阻塞不能放在主線程。視頻幀回調頻率高如果直接在里面更新 UI會導致卡頓。AVFoundation 的 delegate 回調不一定在主線程需要手動切回主隊列更新 UI。6.5 內存管理與生命周期在視頻幀回調中CMSampleBuffer和CVPixelBuffer是高頻創建的對象如果持有引用時間過長內存會快速增長。建議亮度計算完成后不要保留CIImage或CVPixelBuffer的強引用。使用autoreleasepool包裹每幀處理邏輯。在 App 進入后臺時調用stop()回到前臺再start()。示例func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) { autoreleasepool { // 幀處理邏輯 } }6.6 權限處理的工程化真實項目中相機權限不應該只在啟動時請求一次。更合理的方式是啟動時檢查授權狀態。如果被拒絕在 UI 上展示引導頁面。引導用戶去系統設置中開啟。從后臺返回時重新檢查授權狀態。switch AVCaptureDevice.authorizationStatus(for: .video) { case .authorized: // 已有權限直接啟動 case .notDetermined: // 請求權限 AVCaptureDevice.requestAccess(for: .video) { granted in // 處理結果 } case .denied: // 提示用戶去設置開啟 case .restricted: // 家長控制等情況 break }6.7 日志與調試建議相機模塊涉及硬件交互真機問題往往只能在特定設備上復現。建議在關鍵路徑輸出日志// 設備信息 print(設備: \(device.localizedName)) print(曝光范圍: \(device.minExposureTargetBias) ~ \(device.maxExposureTargetBias)) print(當前曝光: \(device.exposureTargetBias)) // 會話狀態 print(session.isRunning: \(session.isRunning))在調試階段打開 AVFoundation 的日志會有大量輸出如果不好定位問題可以先加一個全局日志開關#if DEBUG let isDebugLogEnabled true #else let isDebugLogEnabled false #endif7. 總結與下一步方向Camera Sun 這個項目最核心的價值不是把原生相機的所有功能重寫一遍而是提供一種思路——在系統相機覆蓋不到的場景里用 AVFoundation 構建更符合特定需求的拍攝工具。本文的示例已經覆蓋了自定義相機采集、實時亮度分析、曝光補償調節、點測光對焦這些關鍵能力。你在自己的項目里可以直接復用CameraService和CameraViewModel的代碼結構再根據需要擴展。如果想在這個基礎上繼續深入以下幾件事值得優先研究第一更精細的測光策略。目前的CIAreaAverage是全畫面平均亮度在復雜光線場景下不夠準確?？梢詫W習一下中心重點測光和點測光的算法思路并結合人臉檢測、主體識別來動態選擇測光區域。第二手動對焦與變焦控制。AVFoundation 提供了videoZoomFactor、focusMode、lensPosition等接口可以進一步做成專業相機應用那樣的手動模式。第三RAW 格式與照片處理。如果要走專業方向需要學習AVCapturePhotoOutput的 RAW 輸出能力以及如何在拍攝后做 TONE MAPPING。第四視頻拍攝中的實時曝光調整。如果項目需要支持視頻錄制還要考慮曝光調整過程中畫面的平滑過渡避免錄制過程中亮度突變。相機類 App 的開發門檻不在“能不能調起相機”而在“能不能把畫面效果調到用戶滿意”。希望這篇教程能幫你邁過第一道坎后續的優化空間還很大。如果你在真機調試中遇到其他問題歡迎在評論區交流討論。把代碼跑起來然后試著在夕陽場景下拍一組對比照片你會發現——原來 iPhone 的自定義相機比系統相機的可玩性高得多。 iOS自定義相機實戰：AVFoundation曝光補償與實時亮度分析
之前做 iOS 拍攝類功能時我一直在吐槽 iPhone 原生相機在逆光場景下的體驗明明陽光很好取景器里卻黑成一片點一下亮處對焦整體畫面又過曝得厲害。后來在 Hacker News 上看到一個很有意思的項目叫 “Camera Sun”定位就是針對 iPhone 相機 App 的取景與曝光問題進行改進。這讓我意識到單純吐槽原生相機不夠用不如自己動手在 AVFoundation 層面做一套自定義相機方案把取景亮度分析、曝光補償、手動輔助控件這些能力補全。本文將圍繞這個思路完整拆解一個名為Camera Sun的 iOS 自定義相機項目。先從原生相機的問題場景入手再講清楚 AVFoundation 的采集架構然后給出完整可運行的 SwiftUI AVFoundation 案例代碼最后補充常見報錯排查和工程化建議。無論你是 iOS 新手還是在做自定義相機、掃碼、AR 采集的開發者都可以從中找到可以復用的內容。1. 背景iPhone 原生相機在逆光場景下為什么“不好用”1.1 原生相機的“自動”與“不夠自動”iPhone 自帶相機 App 的拍攝體驗在大多數日常場景下是非常優秀的白平衡、自動曝光、智能 HDR 都做得足夠好。但一旦進入逆光、大光比、強太陽直射這類環境問題就很容易暴露出來取景器畫面偏暗主體輪廓不清晰。點擊暗部對焦亮部直接過曝。點擊亮部對焦暗部又死黑一片。自動曝光系統始終在“你想拍什么”和“天空很亮”之間搖擺。這本質上不是相機硬件不行而是原生相機的自動曝光策略更偏向“整體畫面均衡”在生產級拍攝中我們經常需要的是“對某個區域精準曝光”甚至需要手動干預 EV 補償值。1.2 “Camera Sun”項目想解決的問題“Camera Sun”這個名字很直白——它面向的是“太陽”這種極端光源場景。項目的核心目標是把取景器中的畫面亮度信息用更直觀的方式呈現出來。提供手動曝光補償EV控制。在強光或者逆光環境下幫助用戶先看清畫面再按下快門。用自定義相機方案替代原生相機在某些場景下的不足。放到開發層面它背后的技術點其實就是幾個用 AVFoundation 自定義相機采集流程。實時獲取每一幀畫面的亮度數據。根據亮度分析結果調整曝光參數。在取景界面上疊加輔助控件比如亮度條、點測光框、EV 滑塊。本文的實戰項目會圍繞這四點展開做一個能用模擬器跑通、可以在真機上體驗的 Mini 版本。2. 環境準備與項目結構2.1 開發環境說明本文示例以常見環境為例版本需要根據你的項目實際情況調整項目說明操作系統macOS 12 及以上IDEXcode 14 及以上語言Swift 5.7UI 框架SwiftUI系統框架AVFoundation、CoreImage、UIKit最低部署版本iOS 15.0調試設備建議使用 iPhone 真機需要特別說明的是相機類功能在模擬器中會有很大限制尤其是采集會話、曝光參數調整、亮度回調這些能力模擬器只能模擬部分行為。所以本文的代碼在模擬器上可以運行界面但完整功能建議在真機上驗證。2.2 項目基礎結構我們先在 Xcode 中創建一個 SwiftUI App 項目工程名稱可以叫CameraSunDemo最終文件結構如下CameraSunDemo/ ├── CameraSunDemoApp.swift ├── ContentView.swift ├── Models/ │ └── ExposureState.swift ├── Services/ │ └── CameraService.swift ├── Views/ │ ├── CameraPreviewView.swift │ ├── BrightnessIndicatorView.swift │ └── ExposureControlView.swift └── Info.plist后面所有代碼都會按照這個結構給出文件路徑方便你對照創建。3. 核心原理AVFoundation 相機采集鏈路3.1 從 AVCaptureSession 說起在 iOS 中實現自定義相機核心類是AVCaptureSession。它就像一條“數據管道”把相機硬件采集到的數據經過輸入、輸出兩個端口連接起來。相機硬件 ↓ AVCaptureDeviceInput輸入 ↓ AVCaptureSession會話 ↓ AVCaptureVideoDataOutput輸出回調 ↓ CMSampleBuffer單幀數據與直接調用UIImagePickerController相比使用 AVFoundation 自定義采集可以獲得對每一幀畫面做實時處理的能力。手動控制曝光、對焦、白平衡的權限。更自由的界面定制。更低的延遲。3.2 曝光補償 EV 是什么曝光補償用 EVExposure Value表示單位為 eV簡單理解就是“在你測光結果的基礎上人為地讓畫面更亮或更暗一檔”。iPhone 相機的 AVFoundation 提供了非常直接的控制接口device.setExposureTargetBias(completionHandler:)AVCaptureDevice上的exposureTargetBias屬性可以設置當前曝光補償值范圍通常在minExposureTargetBias到maxExposureTargetBias之間iPhone 一般支持-8.0到8.0實際會根據設備能力有所差異。3.3 實時亮度分析思路在自定義相機中要判斷當前畫面是不是“太黑”或“太亮”最直接的方法是讀取每一幀畫面的平均亮度。常用的實現路徑是AVCaptureVideoDataOutput輸出CMSampleBuffer。將CMSampleBuffer轉成CVPixelBuffer。使用 CoreImage 的CIAreaAverage濾鏡計算平均顏色。將平均顏色的亮度值映射到 UI 上。具體代碼如下func brightness(from pixelBuffer: CVPixelBuffer) - Float? { let ciImage CIImage(cvPixelBuffer: pixelBuffer) let extent ciImage.extent let filter CIFilter(name: CIAreaAverage)! filter.setValue(ciImage, forKey: kCIInputImageKey) filter.setValue(CIVector(cgRect: extent), forKey: kCIInputExtentKey) guard let outputImage filter.outputImage else { return nil } var bitmap [UInt8](repeating: 0, count: 4) let context CIContext(options: [.workingColorSpace: NSNull()]) context.render(outputImage, toBitmap: bitmap, rowBytes: 4, bounds: CGRect(x: 0, y: 0, width: 1, height: 1), format: .RGBA8, colorSpace: nil) let r Float(bitmap[0]) / 255.0 let g Float(bitmap[1]) / 255.0 let b Float(bitmap[2]) / 255.0 // 使用 Rec.709 亮度權重 let brightness 0.2126 * r 0.7152 * g 0.0722 * b return brightness }這里使用CIAreaAverage的原因是它由 CoreImage 底層優化性能比自己遍歷像素要好很多。需要注意的點是CIContext建議復用不要每幀創建。CIAreaAverage的運行耗時取決于圖像大小實際項目建議先縮小圖像再計算。3.4 AVCaptureVideoDataOutput 的像素格式設置要讓上面的亮度計算代碼正常工作需要確保輸出像素格式是 BGRA 或者 RGBA。在創建AVCaptureVideoDataOutput時建議顯式設置videoOutput.videoSettings [ kCVPixelBufferPixelFormatTypeKey as String: kCVPixelFormatType_32BGRA ]如果你不設置系統默認可能輸出 420f也就是kCVPixelFormatType_420YpCbCr8BiPlanarVideoRange這時候直接轉CIImage再走CIAreaAverage也可以但輸出顏色通道需要額外處理不夠直觀。所以我們統一改成 BGRA方便調試。4. 完整實戰實現 Camera Sun 的取景亮度分析與曝光控制下面我們進入核心實戰環節。這一節會逐步完成一個 Mini 版 Camera Sun功能包括啟動自定義相機并顯示實時預覽。分析每一幀畫面的平均亮度。用一個可視化的亮度條展示當前亮度狀態。通過滑塊手動調節曝光補償 EV 值。點擊預覽畫面進行點測光對焦。4.1 創建相機服務類先創建相機采集服務類CameraService它負責整個 AVCaptureSession 的生命周期。文件路徑Services/CameraService.swiftimport AVFoundation import CoreImage import UIKit protocol CameraServiceDelegate: AnyObject { func cameraService(_ service: CameraService, didOutput brightness: Float) func cameraService(_ service: CameraService, didFail error: Error) } final class CameraService: NSObject { private let session AVCaptureSession() private let sessionQueue DispatchQueue(label: com.camerasun.sessionQueue) private let videoOutput AVCaptureVideoDataOutput() private let ciContext CIContext(options: [.workingColorSpace: NSNull()]) private var currentDevice: AVCaptureDevice? weak var delegate: CameraServiceDelegate? var previewLayer: AVCaptureVideoPreviewLayer { let layer AVCaptureVideoPreviewLayer(session: session) layer.videoGravity .resizeAspectFill return layer } override init() { super.init() videoOutput.setSampleBufferDelegate(self, queue: DispatchQueue(label: com.camerasun.videoQueue)) videoOutput.alwaysDiscardsLateVideoFrames true videoOutput.videoSettings [ kCVPixelBufferPixelFormatTypeKey as String: kCVPixelFormatType_32BGRA ] } func start() { sessionQueue.async { [weak self] in self?.configureSession() self?.session.startRunning() } } func stop() { sessionQueue.async { [weak self] in self?.session.stopRunning() } } private func configureSession() { session.beginConfiguration() session.sessionPreset .high guard let device AVCaptureDevice.default(.builtInWideAngleCamera, for: .video, position: .back) else { delegate?.cameraService(self, didFail: CameraError.deviceNotFound) return } currentDevice device do { let input try AVCaptureDeviceInput(device: device) if session.canAddInput(input) { session.addInput(input) } } catch { delegate?.cameraService(self, didFail: error) return } if session.canAddOutput(videoOutput) { session.addOutput(videoOutput) } session.commitConfiguration() } func setExposureBias(_ value: Float) { guard let device currentDevice else { return } do { try device.lockForConfiguration() let clampedValue max(device.minExposureTargetBias, min(device.maxExposureTargetBias, value)) device.setExposureTargetBias(clampedValue) { _ in } device.unlockForConfiguration() } catch { print(鎖定設備配置失敗: \(error)) } } func focusAtPoint(_ point: CGPoint, in previewLayer: AVCaptureVideoPreviewLayer) { guard let device currentDevice else { return } let pointOfInterest previewLayer.captureDevicePointConverted(fromLayerPoint: point) do { try device.lockForConfiguration() if device.isFocusPointOfInterestSupported { device.focusPointOfInterest pointOfInterest device.focusMode .autoFocus } if device.isExposurePointOfInterestSupported { device.exposurePointOfInterest pointOfInterest device.exposureMode .autoExpose } device.unlockForConfiguration() } catch { print(設置對焦失敗: \(error)) } } } extension CameraService: AVCaptureVideoDataOutputSampleBufferDelegate { func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) { guard let pixelBuffer CMSampleBufferGetImageBuffer(sampleBuffer) else { return } if let brightness brightness(from: pixelBuffer) { DispatchQueue.main.async { [weak self] in self?.delegate?.cameraService(self!, didOutput: brightness) } } } private func brightness(from pixelBuffer: CVPixelBuffer) - Float? { let ciImage CIImage(cvPixelBuffer: pixelBuffer) let extent ciImage.extent let filter CIFilter(name: CIAreaAverage)! filter.setValue(ciImage, forKey: kCIInputImageKey) filter.setValue(CIVector(cgRect: extent), forKey: kCIInputExtentKey) guard let outputImage filter.outputImage else { return nil } var bitmap [UInt8](repeating: 0, count: 4) ciContext.render(outputImage, toBitmap: bitmap, rowBytes: 4, bounds: CGRect(x: 0, y: 0, width: 1, height: 1), format: .RGBA8, colorSpace: nil) let r Float(bitmap[0]) / 255.0 let g Float(bitmap[1]) / 255.0 let b Float(bitmap[2]) / 255.0 return 0.2126 * r 0.7152 * g 0.0722 * b } } enum CameraError: LocalizedError { case deviceNotFound var errorDescription: String? { switch self { case .deviceNotFound: return 未找到可用的相機設備 } } }代碼說明使用sessionQueue串行隊列執行會話配置和啟停操作避免主線程阻塞。videoOutput.alwaysDiscardsLateVideoFrames true表示幀數據堆積時丟棄舊幀保證亮度回調的實時性。亮度計算使用 Rec.709 權重更接近人類對亮度的感知。setExposureBias方法會先做min/max范圍約束防止傳入非法值導致崩潰。4.2 創建預覽視圖在 SwiftUI 中接入AVCaptureVideoPreviewLayer最通用的方式是使用UIViewRepresentable包裝一個UIView。文件路徑Views/CameraPreviewView.swiftimport SwiftUI import AVFoundation struct CameraPreviewView: UIViewRepresentable { let previewLayer: AVCaptureVideoPreviewLayer func makeUIView(context: Context) - UIView { let view UIView() view.backgroundColor .black previewLayer.frame view.bounds view.layer.addSublayer(previewLayer) return view } func updateUIView(_ uiView: UIView, context: Context) { DispatchQueue.main.async { previewLayer.frame uiView.bounds } } }這里有一個容易忽略的細節makeUIView執行時UIView的 bounds 可能還不是最終尺寸所以需要在updateUIView中持續更新previewLayer.frame否則預覽畫面可能顯示不全。4.3 創建亮度指示器亮度指示器是 Camera Sun 項目最有辨識度的 UI 之一。它用一條橫向的漸變條展示當前畫面的平均亮度用戶一眼就能看出“現在畫面是偏暗還是偏亮”。文件路徑Views/BrightnessIndicatorView.swiftimport SwiftUI struct BrightnessIndicatorView: View { let brightness: Float let targetBrightness: Float private var normalizedValue: CGFloat { CGFloat(max(0, min(1, brightness))) } var body: some View { GeometryReader { geometry in ZStack(alignment: .leading) { Capsule() .fill(Color.black.opacity(0.6)) .overlay( Capsule() .stroke(Color.white.opacity(0.3), lineWidth: 1) ) // 亮度漸變條 Capsule() .fill( LinearGradient( colors: [.black, .gray, .white], startPoint: .leading, endPoint: .trailing ) ) .frame(width: geometry.size.width * normalizedValue) // 目標亮度指示線 Rectangle() .fill(Color.yellow) .frame(width: 2) .offset(x: geometry.size.width * CGFloat(targetBrightness) - 1) } } .frame(height: 8) } } struct BrightnessIndicatorView_Previews: PreviewProvider { static var previews: some View { BrightnessIndicatorView(brightness: 0.5, targetBrightness: 0.6) .padding() } }這里的targetBrightness可以理解為我們“期望的畫面亮度”比如 0.5 代表中等亮度。當指示條超過目標線時畫面偏亮低于目標線時畫面偏暗。4.4 創建曝光控制滑塊曝光補償是 Camera Sun 的核心交互這里用 SwiftUI 的Slider綁定 EV 值。文件路徑Views/ExposureControlView.swiftimport SwiftUI struct ExposureControlView: View { Binding var exposureValue: Double let range: ClosedRangeDouble var body: some View { VStack(spacing: 8) { HStack { Text(EV) .font(.caption) .foregroundColor(.white) Slider(value: $exposureValue, in: range, step: 0.1) .tint(.yellow) Text(String(format: %.1f, exposureValue)) .font(.caption.monospacedDigit()) .foregroundColor(.white) .frame(width: 50, alignment: .trailing) } HStack { Text(暗) .font(.caption2) .foregroundColor(.white.opacity(0.6)) Spacer() Text(亮) .font(.caption2) .foregroundColor(.white.opacity(0.6)) } } .padding(.horizontal, 16) .padding(.vertical, 12) .background(Color.black.opacity(0.5)) .clipShape(RoundedRectangle(cornerRadius: 12)) .padding(.horizontal, 20) } }4.5 組裝主界面現在把相機預覽、亮度指示器、曝光控制整合到一個界面中。文件路徑Views/ContentView.swiftimport SwiftUI import AVFoundation struct ContentView: View { StateObject private var viewModel CameraViewModel() var body: some View { ZStack { Color.black.ignoresSafeArea() if let previewLayer viewModel.previewLayer { CameraPreviewView(previewLayer: previewLayer) .ignoresSafeArea() } else { ProgressView(相機初始化中...) .foregroundColor(.white) } VStack { Spacer() // 亮度狀態卡片 VStack(alignment: .leading, spacing: 8) { HStack { Image(systemName: sun.max.fill) .foregroundColor(.yellow) Text(亮度分析) .font(.headline) .foregroundColor(.white) Spacer() Text(String(format: %.2f, viewModel.currentBrightness)) .font(.system(.body, design: .monospaced)) .foregroundColor(.white) } BrightnessIndicatorView( brightness: viewModel.currentBrightness, targetBrightness: viewModel.targetBrightness ) Text(viewModel.brightnessDescription) .font(.caption) .foregroundColor(.white.opacity(0.8)) } .padding(16) .background(Color.black.opacity(0.5)) .clipShape(RoundedRectangle(cornerRadius: 16)) .padding(.horizontal, 20) ExposureControlView( exposureValue: $viewModel.exposureValue, range: viewModel.exposureRange ) } } .onAppear { viewModel.start() } .onDisappear { viewModel.stop() } .gesture( DragGesture(minimumDistance: 0) .onEnded { value in viewModel.focusAtPoint(value.location) } ) } } final class CameraViewModel: ObservableObject { Published var previewLayer: AVCaptureVideoPreviewLayer? Published var currentBrightness: Float 0 Published var exposureValue: Double 0 Published var targetBrightness: Float 0.55 Published var exposureRange: ClosedRangeDouble -8.0...8.0 Published var brightnessDescription: String 等待數據... private let cameraService CameraService() private var isUpdatingExposure false init() { cameraService.delegate self preparePreviewLayer() } private func preparePreviewLayer() { // 這里延遲獲取 previewLayer確保 session 已經初始化 DispatchQueue.main.async { [weak self] in guard let self self else { return } self.previewLayer self.cameraService.previewLayer } } func start() { cameraService.start() } func stop() { cameraService.stop() } func focusAtPoint(_ point: CGPoint) { guard let previewLayer previewLayer else { return } cameraService.focusAtPoint(point, in: previewLayer) } } extension CameraViewModel: CameraServiceDelegate { func cameraService(_ service: CameraService, didOutput brightness: Float) { DispatchQueue.main.async { self.currentBrightness brightness switch brightness { case ..0.2: self.brightnessDescription 畫面過暗建議增加曝光補償 case 0.2..0.4: self.brightnessDescription 畫面偏暗可適當增加曝光 case 0.4..0.7: self.brightnessDescription 亮度正常無需調整 case 0.7..0.9: self.brightnessDescription 畫面偏亮可適當降低曝光 default: self.brightnessDescription 畫面過亮建議降低曝光補償 } // 如果有手動曝光調整不自動干預 if abs(self.exposureValue) 0.05 { self.autoAdjustExposureIfNeeded(brightness: brightness) } } } func cameraService(_ service: CameraService, didFail error: Error) { DispatchQueue.main.async { self.brightnessDescription 相機錯誤: \(error.localizedDescription) } } private func autoAdjustExposureIfNeeded(brightness: Float) { guard !isUpdatingExposure else { return } isUpdatingExposure true defer { isUpdatingExposure false } let diff targetBrightness - brightness // 只有偏差超過閾值才調整避免頻繁抖動 if abs(diff) 0.1 { let adjustment Double(diff * 2) let newValue max(-8, min(8, exposureValue adjustment)) cameraService.setExposureBias(Float(newValue)) DispatchQueue.main.async { self.exposureValue newValue } } } }代碼說明CameraViewModel作為中間層負責把CameraService的代理回調轉成 SwiftUI 可觀察的Published屬性。exposureValue被用戶手動拖動后自動曝光調整會暫停避免“用戶想調系統又拉回來”的沖突。亮度描述文本使用區間判斷提示用戶當前畫面狀態。4.6 配置權限在Info.plist中加入相機權限描述keyNSCameraUsageDescription/key stringCamera Sun 需要使用相機來分析和調整拍攝畫面/string不加這一條應用啟動相機采集時會直接崩潰。4.7 運行驗證將上述代碼編譯運行到 iPhone 真機上預期效果如下啟動 App 后進入自定義相機預覽頁面。預覽畫面顯示實時取景。頂部亮度指示條根據畫面亮度實時變化。手動拖動 EV 滑塊后畫面亮度發生明顯變化。手指點擊預覽畫面任意位置相機自動對焦并重新測光。在模擬器上運行時預覽畫面可能是黑屏或者顯示模擬器桌面這是因為模擬器沒有真實相機采集能力。建議盡早使用真機調試。5. 常見問題與排查思路5.1 相機權限彈窗沒有彈出問題現象常見原因解決思路啟動后直接崩潰Info.plist 缺少相機權限描述檢查NSCameraUsageDescription權限彈窗彈出后點擊允許仍然黑屏用戶之前選擇了“不允許”需要在系統設置中開啟提示用戶前往系統設置開啟權限模擬器上沒有彈窗模擬器不支持真實相機使用真機調試5.2 預覽畫面黑屏問題現象常見原因解決思路預覽全黑但相機權限已開啟AVCaptureVideoPreviewLayer沒有正確添加到視圖層級檢查previewLayer.frame是否更新預覽區域黑屏但亮度數據有回調previewLayer被釋放使用強引用保存 previewLayer從后臺返回后黑屏未在viewWillAppear重新啟動 session在scenePhase變化時重新startRunning()5.3 亮度數據不刷新如果cameraService(_:didOutput:)一直不回調優先檢查AVCaptureVideoDataOutput是否成功添加到 sessionif session.canAddOutput(videoOutput) { session.addOutput(videoOutput) } else { print(無法添加 videoDataOutput) }另外AVCaptureVideoDataOutput需要強引用不要聲明為局部變量。5.4 EV 滑塊拖動后畫面沒有變化可能原因當前設備isExposureTargetBiasSupported為false。設備沒有成功lockForConfiguration()。EV 值沒有落在minExposureTargetBias...maxExposureTargetBias范圍內。排查代碼print(曝光補償范圍: \(device.minExposureTargetBias) ~ \(device.maxExposureTargetBias)) print(是否支持曝光補償: \(device.isExposureTargetBiasSupported))5.5 性能問題掉幀和發熱每幀都執行CIAreaAverage在真機上通常不會有太大壓力但如果你的項目比較復雜可以考慮以下優化方式降低采樣幀率比如每 3 幀計算一次亮度。縮小計算區域使用CIImage的cropped(to:)只分析畫面中心區域。降低視頻輸出分辨率使用session.sessionPreset .medium。避免在主線程做任何 CoreImage 操作。降低采樣幀率的示例private var frameCount 0 func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) { frameCount 1 guard frameCount % 3 0 else { return } // 亮度計算 }6. 最佳實踐與工程建議6.1 曝光控制的策略選擇Camera Sun 項目里我把曝光控制做成了兩種模式混合用戶不干預時系統根據亮度信息自動調整 EV。用戶手動調整后以用戶設置為準。這種設計的核心思路是不跟用戶搶控制權。原生相機之所以在一些場景下給人“不聽話”的感覺恰恰是因為自動策略太強勢。在自定義相機中我們應該把自動策略看成“默認值”而不是“唯一值”。在實際業務中還可以增加一個“自動/手動”切換開關讓用戶明確知道當前處于哪種模式。6.2 亮度分析的通用性CIAreaAverage計算的是全畫面平均亮度但在很多場景下它并不準確。例如畫面左邊是太陽右邊是陰影平均亮度可能正好落在 0.5。但用戶真正想拍的主體在陰影里需要的是“陰影區域”的亮度數據。更合理的方式是引入區域權重// 只分析畫面中心 60% 區域的亮度 let centerRect CGRect(x: extent.width * 0.2, y: extent.height * 0.2, width: extent.width * 0.6, height: extent.height * 0.6) let centerImage ciImage.cropped(to: centerRect)這樣在逆光場景下自動曝光會更偏向畫面中心的主體。6.3 設備配置的邊界檢查AVFoundation 的 API 在不同 iOS 版本、不同設備上有很大差異。比如某些設備支持builtInDualCamera某些只有builtInWideAngleCamera。不同設備的minExposureTargetBias和maxExposureTargetBias范圍不同。某些設備支持autoFocusRangeRestriction某些不支持。所以在做設備配置時一定要先查詢能力再設置屬性if device.isExposurePointOfInterestSupported { device.exposurePointOfInterest point }6.4 線程模型的必要性在CameraService中我使用了三個隊列sessionQueue配置會話、啟停相機。videoQueue接收視頻幀回調。主隊列更新 UI。原因是相機配置操作耗時且阻塞不能放在主線程。視頻幀回調頻率高如果直接在里面更新 UI會導致卡頓。AVFoundation 的 delegate 回調不一定在主線程需要手動切回主隊列更新 UI。6.5 內存管理與生命周期在視頻幀回調中CMSampleBuffer和CVPixelBuffer是高頻創建的對象如果持有引用時間過長內存會快速增長。建議亮度計算完成后不要保留CIImage或CVPixelBuffer的強引用。使用autoreleasepool包裹每幀處理邏輯。在 App 進入后臺時調用stop()回到前臺再start()。示例func captureOutput(_ output: AVCaptureOutput, didOutput sampleBuffer: CMSampleBuffer, from connection: AVCaptureConnection) { autoreleasepool { // 幀處理邏輯 } }6.6 權限處理的工程化真實項目中相機權限不應該只在啟動時請求一次。更合理的方式是啟動時檢查授權狀態。如果被拒絕在 UI 上展示引導頁面。引導用戶去系統設置中開啟。從后臺返回時重新檢查授權狀態。switch AVCaptureDevice.authorizationStatus(for: .video) { case .authorized: // 已有權限直接啟動 case .notDetermined: // 請求權限 AVCaptureDevice.requestAccess(for: .video) { granted in // 處理結果 } case .denied: // 提示用戶去設置開啟 case .restricted: // 家長控制等情況 break }6.7 日志與調試建議相機模塊涉及硬件交互真機問題往往只能在特定設備上復現。建議在關鍵路徑輸出日志// 設備信息 print(設備: \(device.localizedName)) print(曝光范圍: \(device.minExposureTargetBias) ~ \(device.maxExposureTargetBias)) print(當前曝光: \(device.exposureTargetBias)) // 會話狀態 print(session.isRunning: \(session.isRunning))在調試階段打開 AVFoundation 的日志會有大量輸出如果不好定位問題可以先加一個全局日志開關#if DEBUG let isDebugLogEnabled true #else let isDebugLogEnabled false #endif7. 總結與下一步方向Camera Sun 這個項目最核心的價值不是把原生相機的所有功能重寫一遍而是提供一種思路——在系統相機覆蓋不到的場景里用 AVFoundation 構建更符合特定需求的拍攝工具。本文的示例已經覆蓋了自定義相機采集、實時亮度分析、曝光補償調節、點測光對焦這些關鍵能力。你在自己的項目里可以直接復用CameraService和CameraViewModel的代碼結構再根據需要擴展。如果想在這個基礎上繼續深入以下幾件事值得優先研究第一更精細的測光策略。目前的CIAreaAverage是全畫面平均亮度在復雜光線場景下不夠準確?？梢詫W習一下中心重點測光和點測光的算法思路并結合人臉檢測、主體識別來動態選擇測光區域。第二手動對焦與變焦控制。AVFoundation 提供了videoZoomFactor、focusMode、lensPosition等接口可以進一步做成專業相機應用那樣的手動模式。第三RAW 格式與照片處理。如果要走專業方向需要學習AVCapturePhotoOutput的 RAW 輸出能力以及如何在拍攝后做 TONE MAPPING。第四視頻拍攝中的實時曝光調整。如果項目需要支持視頻錄制還要考慮曝光調整過程中畫面的平滑過渡避免錄制過程中亮度突變。相機類 App 的開發門檻不在“能不能調起相機”而在“能不能把畫面效果調到用戶滿意”。希望這篇教程能幫你邁過第一道坎后續的優化空間還很大。如果你在真機調試中遇到其他問題歡迎在評論區交流討論。把代碼跑起來然后試著在夕陽場景下拍一組對比照片你會發現——原來 iPhone 的自定義相機比系統相機的可玩性高得多。