用途:面向 Apple 平台的 AVFoundation 音频开发参考,帮助开发者查阅 AVAudioSession 配置、AVAudioEngine 管线搭建、低延迟录音、位完美输出与空间音频采集等主题。
主要能力:一是 AVAudioSession 的分类(ambient、playback、record、playAndRecord、multiRoute 等)、模式(default、voiceChat、measurement、moviePlayback、spokenAudio 等)与选项(mixWithOthers、duckOthers、allowBluetooth、allowBluetoothA2DP 等)速查;二是 AVAudioEngine 管线搭建,包括 AVAudioPlayerNode、输入/输出节点、混音器及 EQ、混响、延迟、失真、变速变调等节点,以及 installTap 音频分析与 AVAudioConverter 格式转换;三是 iOS 26+ 新特性,如 AVInputPickerInteraction 输入设备选择、AirPods 高品质蓝牙录音、First Order Ambisonics 空间音频采集与 AVAssetWriter 空间音频写入;四是位完美 DAC 输出说明与采样率注意事项;五是音画分离与 Audio Mix(Cinematic 框架、AUAudioMix);六是后台播放、音频闪避、蓝牙设备处理等常见模式;七是分类选择错误、未处理中断、Tap 泄漏、格式不匹配、未激活会话等反模式提醒。
使用方式:以 Swift 代码片段示范,例如调用 setCategory 与 setActive、用 engine.attach/connect/start 搭建管线、在输入节点 installTap 分析电平、监听 interruptionNotification 与 routeChangeNotification、用 AVInputPickerInteraction 呈现选择器。必要命令与代码保持原样。
适用场景:iOS/iPadOS/macOS 音频播放器、录音、VoIP、DJ 多路输出、空间音频与沉浸式视频相关开发。
限制:文档中价格、授权、具体性能指标暂未提供;部分 API 标注为 iOS 26+,核心功能标注 iOS 12+;涉及 Cinematic、AVKit 等框架的细节需结合官方文档;本文仅为参考,不含完整可运行工程。