用途:这是 AVFoundation 相机采集相关 API 的速查参考(axiom-camera-capture-ref),面向 iOS 开发者在实现拍照、录像与预览时查阅关键类型、配置项和调用方式。正文以 Swift 代码片段与表格形式组织,不提供完整应用架构,也未说明价格、平台版本要求或收费方式。
主要能力:涵盖会话设置与预设(.photo、.high、.hd4K3840x2160 等)、会话生命周期(startRunning/stopRunning、isRunning、isInterrupted)与中断、错误通知;设备获取与类型(广角、超广角、长焦、双/三摄、TrueDepth、LiDAR)、锁配置下的对焦、曝光、闪光灯与变焦,以及前后摄像头切换和授权状态检查;iOS 17+ 的 AVCaptureDevice.RotationCoordinator 旋转角度与 KVO 观测;AVCapturePhotoOutput 的高分辨率、Live Photo、景深、人像效果蒙版、Zero Shutter Lag、Responsive Capture、Fast Capture Prioritization、Auto Deferred Photo Delivery 等支持性开关,以及 AVCapturePhotoOutputReadinessCoordinator 快门就绪状态回调;AVCapturePhotoSettings 的格式(JPEG/HEIF/RAW/RAW+JPEG)、质量优先级、闪光、ProRAW/HDR、分辨率、预览与缩略图配置;拍照委托回调(含 deferred photo proxy);AVCaptureMovieFileOutput 录像、音频输入、文件输出委托;以及 AVCaptureVideoPreviewLayer 预览相关片段。
使用方式:代码示例按主题分组,通常先创建 session 与 sessionQueue,在后台队列内 beginConfiguration/commitConfiguration 添加输入输出,再 startRunning;拍照前配置 settings 并调用 capturePhoto;录像调用 startRecording/stopRecording 并实现对应 delegate。文档提示 startRunning 为阻塞调用,须在后台队列执行;AVCapturePhotoSettings 每次拍摄需新建实例,可用 AVCapturePhotoSettings(from:) 复制;切换摄像头应在会话队列内、beginConfiguration 与 commitConfiguration 之间进行。
适用场景与限制:适合需要直接使用 AVFoundation 控制采集流程的 iOS 相机功能开发参考。资料为速查性质,名称、URL 与代码片段按原文保留;未提供的功能、收费、价格、平台细节和步骤在此不展开。部分 API 标注 iOS 17+;ProRAW 需 iPhone 12 Pro 或更高机型;HDR/Deep Fusion 由系统按质量设置自动处理,无需单独开关。