SquareCam 範例展示如何用 AVFoundation 建立自訂相機預覽,加入即時人臉偵測,並在畫面上以方形框標示人臉。它還示範了拍照閃光動畫、前後鏡頭切換、縮放手勢與方向處理。
相機核心是 AVCaptureSession。範例會依裝置類型設定 session preset,加入 AVCaptureDeviceInput,並建立 AVCaptureStillImageOutput 與 AVCaptureVideoDataOutput。前者負責高品質靜態影像,後者負責即時影格串流。
AVCaptureVideoPreviewLayer 可把相機畫面顯示在 layer 上。為了做即時人臉偵測,範例會把 video data output 的影格送到背景佇列,再從 CMSampleBuffer 取得 CVPixelBuffer,建立 CIImage,交給 CIDetector 偵測。
由於裝置方向會影響影像與特徵座標,範例會依 UIDeviceOrientation 設定 EXIF orientation,並在繪製人臉框時處理鏡像、旋轉與縮放。這部分是相機應用中容易出錯的細節,需要特別注意。
偵測到 CIFaceFeature 後,程式會建立或重用名為 FaceLayer 的 CALayer,把方形圖片設為 contents,並依 face bounds 調整 frame。為了避免隱藏式動畫造成閃爍,會使用 CATransaction 並關閉 actions。拍照時則透過 KVO 監聽 capturingStillImage,做出白色閃光動畫。
切換前後鏡頭時,會重新建立 AVCaptureDeviceInput,並在 beginConfiguration 與 commitConfiguration 之間移除舊 input、加入新 input。縮放則透過 UIPinchGestureRecognizer 計算 effectiveScale,再以 CATransaction 對 previewLayer 做 transform。
這個範例的價值在於把 AVFoundation、Core Image、Core Animation 與手勢操作整合在一起。學習時可先拆解成相機啟動、影格輸出、人臉偵測、座標轉換、圖層繪製與互動控制幾個部分,再逐步理解每個 API 的角色。