🎬 为什么Camera Control是移动摄影的未来？ 想象一下：你在最喜欢的乐队的演唱会上。人群从四面八方挤压，双手被占用，你正试图拍下完美的照片。以前，你不得不笨拙地点击屏幕，冒着手机掉落的风险。现在，只需按下iPhone 16的侧边按钮一次 — 瞬间就被捕捉了。 这不是科幻小说。这是Camera Control — Apple近年来在移动摄影领域最重要的创新之一。 你将学到什么 在本指南中，我们将从零开始走完Camera Control集成的完整旅程： - Camera Control架构如何工作以及为什么这样工作 - 从零开始的项目设置步骤 - 创建锁屏相机扩展（在设置中显示所必需的） - 添加系统缩放和曝光控制 - 处理快门按钮事件 - UIKit和SwiftUI的集成 - 解决常见问题和调试 --- 📱 什么是Camera Control及其工作原理？ Camera Control不仅仅是"另一个按钮"。它是一个将硬件、软件API和直观用户界面结合在一起的完整生态系统。 硬件基础 在iPhone 16及更新型号中，侧边按钮配备了特殊传感器： - Force Touch — 检测按压力度 - 电容感应 — 识别触摸和滑动 - 触觉反馈 — 提供触觉响应 这种组合使按钮可以作为： - 相机快门（完全按下） - 设置滑块（在按钮上滑动） - 模式切换器（双击） Camera Control的三个主要功能 1. 应用启动 — Camera Control可以直接从锁屏打开你的应用 2. 快门按钮 — 物理按压用于拍照或开始/停止视频 3. 参数调整 — 在按钮上滑动以调整缩放、曝光和其他参数 --- 🎯 要求和兼容性 在编写代码之前，确保你的项目满足要求。 系统要求 | 组件 | 最低版本 | |-----------|-----------------| | iOS | 18.0+ | | 设备 | iPhone 16, 16 Plus, 16 Pro, 16 Pro Max | | Xcode | 16.0+ | | Swift | 5.9+ | 所需框架 swift import AVFoundation // 相机工作的主要框架 import AVKit // 用于AVCaptureEventInteraction import Photos // 用于将照片保存到相册 代码中检查兼容性 使用前务必检查Camera Control的可用性： swift func checkCameraControlSupport -> Bool { // 检查iOS版本 guard availableiOS 18.0, else { print"❌ 需要iOS 18.0或更高版本" return false } // 检查设备支持 let session = AVCaptureSession guard session.supportsControls else { print"❌ 设备不支持Camera Control" return false } print"✅ Camera Control完全支持" return true } > ⚠️ 重要: supportsControls属性仅在iPhone 16及更新设备上返回true。在模拟器和旧设备上始终为false。 --- 🏗️ 项目架构 推荐的文件结构 CameraControlApp/ ├── CameraControlApp.xcodeproj ├── CameraControlApp/ │ ├── App/ │ │ ├── CameraControlApp.swift // 入口点 SwiftUI │ │ └── AppDelegate.swift // 可选，用于UIKit │ ├── Camera/ │ │ ├── CameraController.swift // 主相机逻辑 │ │ ├── CameraPreviewView.swift // UIKit预览 │ │ └── CameraModel.swift // SwiftUI的ObservableObject │ ├── Views/ │ │ ├── CameraView.swift // SwiftUI相机视图 │ │ └── CameraViewController.swift // UIKit控制器 │ └── Extensions/ │ └── AVCaptureSession+Extensions.swift ├── LockScreenCameraExtension/ // 锁屏扩展 │ ├── LockScreenCameraExtension.swift │ └── Info.plist └── Tests/ └── CameraControlTests.swift --- 🔧 步骤1：创建CameraController CameraController是管理所有相机和Camera Control逻辑的类。 swift import AVFoundation import AVKit import Photos /// 支持Camera Control的主相机控制器 class CameraController: NSObject, ObservableObject { // MARK: - 公共属性 /// 当前缩放倍数 @Published var currentZoomFactor: CGFloat = 1.0 /// 当前曝光偏移 @Published var currentExposureBias: Float = 0.0 /// Camera Control叠加层是否激活 @Published var isCameraControlActive: Bool = false /// 最后捕获的图像（用于预览） @Published var lastCapturedImage: UIImage? /// 相机权限状态 @Published var permissionStatus: AVAuthorizationStatus = .notDetermined // MARK: - 内部属性 /// 捕获会话 — AVFoundation的核心对象 let session = AVCaptureSession /// 会话配置队列（绝对不要在主线程上！） private let sessionQueue = DispatchQueue label: "com.yourapp.camera.session", qos: .userInitiated /// 照片输出 private let photoOutput = AVCapturePhotoOutput /// 相机输入 private var deviceInput: AVCaptureDeviceInput? /// KVO观察者存储 private var observations: NSKeyValueObservation = // MARK: - 初始化 override init { super.init checkPermissions } // MARK: - 权限处理 /// 检查并请求相机权限 func checkPermissions { switch AVCaptureDevice.authorizationStatusfor: .video { case .authorized: permissionStatus = .authorized configureSession case .notDetermined: sessionQueue.suspend AVCaptureDevice.requestAccessfor: .video { weak self granted in guard let self = self else { return } DispatchQueue.main.async { self.permissionStatus = granted ? .authorized : .denied } if granted { self.configureSession } self.sessionQueue.resume } case .denied, .restricted: permissionStatus = .denied print"⚠️ 相机访问被拒绝" @unknown default: break } } // MARK: - 会话配置 /// 配置AVCaptureSession private func configureSession { sessionQueue.async { weak self in guard let self = self else { return } self.session.beginConfiguration self.session.sessionPreset = .photo // 配置相机输入 guard self.setupCameraInput else { self.session.commitConfiguration return } // 配置照片输出 guard self.setupPhotoOutput else { self.session.commitConfiguration
