SuperAPI AI 工具集

avfoundation-audio

编程与开发

查看项目

更新于 10-16 07:15

技能介绍

用途:面向 iOS 与 iPadOS,讲解如何配置 AVAudioSession,并构建 AVAudioEngine 节点图,用于播放、录音、实时 DSP 与多轨音频管线。

主要能力与要点: 一是音频会话配置。AVAudioSession 负责协调应用音频与系统音频子系统。建议延迟到播放或录音开始时才激活,避免过早静音后台音频。资料给出配置播放、录音与取消激活的示例,使用 setCategory、setActive 等方法。关键分类与模式包括:.playback(静音开关或锁屏下仍继续播放)、.record(纯录音,会静音后台音频)、.playAndRecord(双向音频,如 VoIP、聊天或边录边监听,可用 .defaultToSpeaker 避免只走听筒)、.ambient(与其他应用混音,受静音开关影响)。 二是中断与路由变化处理。应始终异步观察 AVAudioSession.interruptionNotification 与 AVAudioSession.routeChangeNotification。资料给出用 NotificationCenter 异步序列的观察者实现示例,处理 .began 与 .ended(含 .shouldResume)。当路由变化原因为 .oldDeviceUnavailable(例如耳机拔出)时应立即暂停播放。 三是 AVAudioEngine 架构。AVAudioEngine 协调由 AVAudioNode(播放器节点、混音节点、效果节点)连接而成的图。资料示例展示用 AVAudioFile 读取、attach 播放器节点、连接主混音节点、启动引擎、调度文件与播放,以及停止与重置。

四是实时麦克风采集与 Tap。要分析或流式处理麦克风 PCM 缓冲,可在 inputNode 上安装音频 Tap。资料示例展示读取 outputFormat(forBus:)、先 removeTap(onBus:) 再 installTap(onBus:bufferSize:format:)、prepare 与 start,以及停止时移除 Tap。开始麦克风采集前应检查并请求 AVAudioApplication.requestRecordPermission()。

常见错误:在应用启动时激活会话会导致后台音频被意外挂起;引擎连接中音频格式不匹配(采样率或声道数不兼容且无混音器或格式转换器)会抛异常;重复安装 Tap 会在运行时崩溃,必须先 removeTap;忽略路由丢失会在耳机断开后从内置扬声器外放;会话重置后仍持有 AVAudioEngine 需处理 AVAudioEngineConfigurationChange,重建图或重启引擎。

审查清单涉及:分类、模式与选项是否合适;setActive(true) 是否延迟到真正开始播放或录音;停止时是否以 .notifyOthersOnDeactivation 取消激活;是否观察路由变化并在 .oldDeviceUnavailable 暂停;是否处理中断;麦克风采集前是否请求权限;重新安装或停止前是否正确移除 Tap。

限制与未提供信息:资料未提供价格、收费、平台支持版本、性能数据或具体安装与集成步骤,这些内容暂未提供。