avfoundation-audiolisted
Install: claude install-skill thienqo/ios-skills
# AVFoundation Audio
Configure `AVAudioSession` and construct `AVAudioEngine` node graphs for playback, recording, real-time DSP, and multi-track audio pipelines in iOS and iPadOS.
## Contents
- [Audio Session Configuration](#audio-session-configuration)
- [Interruption & Route Change Handling](#interruption--route-change-handling)
- [AVAudioEngine Architecture](#avaudioengine-architecture)
- [Live Microphone Capture & Taps](#live-microphone-capture--taps)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Audio Session Configuration
`AVAudioSession` coordinates app audio with the system audio subsystem. Defer activation until playback or recording begins to avoid prematurely silencing background audio.
```swift
import AVFAudio
@MainActor
final class AudioSessionManager {
static let shared = AudioSessionManager()
func configurePlayback() throws {
let session = AVAudioSession.sharedInstance()
try session.setCategory(.playback, mode: .moviePlayback, options: [])
try session.setActive(true)
}
func configureRecording() throws {
let session = AVAudioSession.sharedInstance()
try session.setCategory(
.playAndRecord,
mode: .measurement,
options: [.defaultToSpeaker, .allowBluetoothHFP]
)
try session.setActive(true)
}
func deactivate() throws {
try AVAudioSession.sharedInstance().setActive(false,