AVAudioSessionは、iOSアプリが「自分は音をどう使うつもりか」をOSに宣言するための仕組みです。音を鳴らす処理そのものはAVAudioPlayerやAVAudioEngineが担当しますが、サイレントスイッチで消音されるか、他のアプリの音楽を止めるか、マイクを使えるかは、AVAudioSessionの設定で決まります。再生コードが正しいのに音が出ないときは、まずここを疑うと切り分けが早く済みます。
この記事では、カテゴリ・モード・カテゴリオプションの3つの設定軸を表で一覧にし、Swiftの実装例を示します。版番号はすべて2026年11月8日時点のApple公式ドキュメントのAVAudioSessionで引き直しました。日本語の解説記事の多くは2014〜2021年のもので、iOS 17で録音許可がAVAudioApplicationへ移ったこと、iOS 27で割り込みの受け方が変わったことには触れていません。古い記事のコードをそのまま写すと非推奨APIを踏みます。
まとめ:AVAudioSessionの設定順と押さえどころ
決める順番は「カテゴリ→モード→オプション→有効化」です。音楽・動画の再生アプリならplayback、通話や録音を伴うならplayAndRecordを選び、モードは通話ならvoiceChat、それ以外はdefaultのままにします。オプションは、他アプリの音と共存させたいときだけmixWithOthersかduckOthersを足します。カテゴリとモードは用途に応じて設定し、メディアサービスのリセット後には設定し直します。有効化と無効化は再生の開始・終了や割り込みに合わせて行います。
そのうえで押さえる点は次の5つです。
- 画面ロック後も鳴らし続けるには、カテゴリだけでなくInfo.plistのUIBackgroundModesにaudioが要る
- 録音許可の取得はiOS 17からAVAudioApplicationの担当で、AVAudioSession側の同名APIは非推奨
- 割り込みは、iOS 26以前はinterruptionNotificationのbegan/ended、iOS 27以降はdidBecomeInactiveNotificationとresumptionRecommendationNotificationで受ける(AVPlayerは自前で一時停止するので、AVAudioPlayerやAVAudioEngineを直接動かす実装で必要)
- イヤホンを抜いたら止める処理と、メディアサービスのリセット後の再構築は自分で書く
- 再生を終えてセッションを閉じるときはnotifyOthersOnDeactivationを付け、中断させた音楽アプリが戻れるようにする
| やりたいこと | カテゴリ | モード | 追加で必要なもの |
|---|---|---|---|
| 音楽・動画の再生(サイレント時も鳴らす) | playback | default / moviePlayback | UIBackgroundModes に audio |
| ゲームの効果音(BGMアプリを止めない) | ambient | default | なし(既定でミックス) |
| VoIP通話・ボイスチャット | playAndRecord | voiceChat | NSMicrophoneUsageDescription |
| ボイスメモ・録音アプリ | playAndRecord | default | 録音許可の取得 |
| 読み上げ・音声ガイド | playback | spokenAudio / voicePrompt | なし |
| 他アプリの音量を下げて割り込む | playback | default | オプション duckOthers |
AVAudioSessionの役割とデフォルト動作
AVAudioSessionはAVFAudioフレームワークのクラスで、公式ドキュメントに載っている対応プラットフォームはiOS 3.0・iPadOS 3.0・Mac Catalyst 13.1・tvOS 9.0・visionOS 1.0・watchOS 2.0です。macOSは入っていません。Mac Catalystを使わないmacOSアプリでは、このクラス自体が使えず、入出力デバイスの選択はCore Audioの側で行います。
実体はシングルトンで、AVAudioSession.sharedInstance()で取得します。アプリ全体で1つの状態を共有するので、ライブラリの内部と画面側の両方でカテゴリを書き換えると、後から呼んだほうが勝ちます。設定を触る場所はアプリ内で1か所に寄せてください。
何も設定しない場合の既定はsoloAmbientカテゴリです。録音はできず、サイレントスイッチをオンにすると音が消え、画面をロックすると音が止まり、他アプリのバックグラウンド再生は自分のセッションを有効化した時点で中断されます。音楽プレイヤー・動画プレイヤー・通話アプリ・録音アプリはいずれもこの既定と要件が合わないため、明示的な設定が必要です。
カテゴリ7種の選び方
カテゴリは、アプリの音の使い方を大づかみに宣言する設定です。AVAudioSession.Categoryには7つありますが、audioProcessingは「もはや不要」としてiOS 10で非推奨になっています。実質は6択です。
| カテゴリ | 再生 | 録音 | サイレント時 | 既定のミックス | 主な用途 |
|---|---|---|---|---|---|
| soloAmbient(既定) | 可 | 不可 | 消音 | しない | 指定しなかったときの既定 |
| ambient | 可 | 不可 | 消音 | する | 効果音・UI音 |
| playback | 可 | 不可 | 鳴る | しない | 音楽・動画・読み上げ |
| record | 不可 | 可 | 該当なし | しない | 出力を完全に止めたい録音 |
| playAndRecord | 可 | 可 | 鳴る | しない | 通話・録音アプリ全般 |
| multiRoute | 可 | 可 | 鳴る | しない | 複数の入出力を同時に使う |
| audioProcessing | 不可 | 不可 | 該当なし | しない | iOS 10で非推奨 |
迷いやすいのはrecordとplayAndRecordの使い分けです。公式ドキュメントはrecordについて「セッションが有効な間、システム上のほぼすべての出力を無音にする。予期しない音の再生を防ぐ必要がないかぎりplayAndRecordを使うこと」と書いています。録音中に操作音やプレビュー再生を鳴らしたいなら、playAndRecordを選びます。なお、recordでも電話・アラームなどミックス不可のセッションからの割り込みは防げません。
サイレントスイッチを無視して鳴らしたいなら、playback・playAndRecord・multiRouteのいずれかにします。ambientとsoloAmbientは消音されるので、アラームや通知音の用途には向きません。
モード11種とiOS 26系での追加分
モードは、選んだカテゴリの中で用途をさらに細かく指定する設定です。たとえばvoiceChatを設定すると、音声向けに音色が調整され、使える経路がボイスチャット向けに絞られ、allowBluetoothHFPオプションが自動で付きます。ただし公式ドキュメントによれば、エコーキャンセルなどの音声処理はAudio UnitのVoice I/OかsetVoiceProcessingEnabled(_:)を使わないと適用されません。モードを設定しただけでは効かない点に注意してください。
| モード | 用途 | 追加 |
|---|---|---|
| default | 既定のモード | iOS 5.0 |
| voiceChat | VoIPなど双方向の音声通話 | iOS 5.0 |
| videoChat | ビデオ会議 | iOS 7.0 |
| gameChat | GameKitのボイスチャット(GameKitが設定) | iOS 5.0 |
| videoRecording | 動画の録画 | iOS 5.0 |
| measurement | 音声入出力の測定 | iOS 5.0 |
| moviePlayback | 映像コンテンツの再生 | iOS 6.0 |
| spokenAudio | ポッドキャストなど連続した音声 | iOS 9.0 |
| voicePrompt | 音声合成による短い案内 | iOS 12.0 |
| shortFormVideo | 短尺動画の再生(playbackのみ) | iOS 26.0 |
| dualRoute | 内蔵と副デバイスの入出力を同時に使う | iOS 26.2 |
spokenAudioとvoicePromptは名前が似ていますが、役割は逆です。spokenAudioは「他のアプリが音声プロンプトを流したら、ダッキングではなく一時停止される側」で、オーディオブックやポッドキャスト向けです。voicePromptはその短い案内を出す側で、公式が挙げる例はターンバイターンのナビゲーションアプリです。案内を出す側は、duckOthersとinterruptSpokenAudioAndMixWithOthersを併せて設定するのが通例とされています。
iOS 26系で追加された2つのモードには、カテゴリ側の制約があります。shortFormVideoはplaybackカテゴリでのみ有効です。dualRouteは公式ドキュメントが「multiRouteカテゴリでのみ使用でき、加えてallowBluetoothHFPオプションの設定が必要」としており、playAndRecordに付けても効きません。どちらも古いOSでは存在しないので、対応範囲を広く取るアプリではif #available(iOS 26.2, *)のような分岐が要ります。
カテゴリオプション11種とallowBluetoothの改称
カテゴリオプションは、カテゴリの既定の振る舞いを部分的に上書きする設定です。AVAudioSession.CategoryOptionsはOptionSetなので複数を同時に指定できますが、カテゴリごとに使えるオプションが決まっており、対応しない組み合わせでは、setCategoryがエラーになる場合と、オプションが暗黙に外される場合があります(allowBluetoothA2DPはmultiRouteとrecordで暗黙に外れます)。エラーが出なかったことを、設定が効いた証拠にしないでください。
| オプション | 効果 | 備考 |
|---|---|---|
| mixWithOthers | 他アプリの音を止めずに重ねる | playAndRecord / playback / multiRoute |
| duckOthers | 有効な間、他アプリの音量を下げる | 指定すると mixWithOthers も立つ |
| interruptSpokenAudioAndMixWithOthers | spokenAudioのセッションだけ止める | iOS 9.0。mixWithOthers も立つ |
| allowBluetoothHFP | ハンズフリー機器をマイクに使う | playAndRecord / record ほか |
| allowBluetooth | 同上(旧名) | 公式がHFPへの改称を記録 |
| allowBluetoothA2DP | A2DP機器へ高音質で出力 | iOS 10.0。出力専用 |
| allowAirPlay | AirPlay機器へ出力 | iOS 10.0。明示は playAndRecord のみ |
| defaultToSpeaker | 既定の出力を内蔵スピーカーにする | playAndRecord のみ |
| overrideMutedMicrophoneInterruption | マイクのミュートで割り込ませない | iOS 14.5 |
| bluetoothHighQualityRecording | 対応機器でフル帯域の録音 | iOS 26.0。defaultモード限定・EU非対応 |
| farFieldInput | 遠距離集音の入力を優先 | iOS 26.2。allowBluetoothHFP 必須 |
allowBluetoothは、公式ドキュメント上でallowBluetoothHFPへの改称が記録されています。値の意味は同じで既存コードがすぐ壊れるわけではありませんが、新しく書くコードではallowBluetoothHFPを使います。
HFPとA2DPは別物です。HFPは通話用プロファイルで双方向(マイクも使える)ですが、音質は電話品質に落ちます。A2DPは公式ドキュメントが「音楽再生など帯域の大きい用途向けのステレオ・出力専用プロファイル」と説明しているもので、マイクは使えません。録音アプリでBluetoothマイクを使って音がこもる場合は、まずcurrentRouteで入力がHFPに切り替わっていないかを確認します。HFPなら電話品質の帯域になるのは仕様どおりです。iOS 26のbluetoothHighQualityRecordingはこの制約を緩めるオプションですが、公式ドキュメントは「一部のAirPodsなど対応する経路でのみ有効」「defaultモードのときだけ要求できる」「現時点でEUではサポートされない」「入力遅延が増えることがあり、リアルタイム通信には推奨しない」と4つの条件を付けています。対応可否は入力ポートのbluetoothMicrophoneExtensionでhighQualityRecordingを調べて判定します。
Swift実装:セッションの設定・有効化・終了
カテゴリ設定とsetActiveでの有効化
設定はsetCategory(_:mode:options:)で1回にまとめ、そのあとsetActive(true)で有効化します。公式ドキュメントは「通常、有効化する前にカテゴリとモードを設定する。有効化した状態で変更すると即座に反映される」としています。
playbackは既定でミックス不可なので、有効化した瞬間に他アプリの再生が止まります。再生ボタンを持つアプリなら、カテゴリ設定は起動時に済ませ、有効化はユーザーが再生を始めるまで待ってください。下の関数は、その再生開始時に呼ぶ想定です。
import AVFAudio
func configureForPlayback() {
let session = AVAudioSession.sharedInstance()
do {
try session.setCategory(.playback, mode: .default, options: [])
try session.setActive(true)
} catch {
print("audio session setup failed: \(error)")
}
}
setCategoryもsetActiveもthrowsなので、この例ではdo-catchで受けています。呼び出し元へエラーを伝える設計でも構いません。setActive(_:options:)の公式ドキュメントによれば、通話など優先度の高いセッションがあり、どちらもミックスを許していない場合、有効化は失敗します。別アプリが通話中にrecordかplayAndRecordで有効化するとinsufficientPriorityエラーになり、playbackなら有効化できます(SharePlayの開始などのため)が、通話のマイクは取れません。この例の関数は失敗をログに出すだけなので、再生処理とつなぐときはthrowsにするか戻り値で結果を返し、有効化に成功したときだけ再生を始めます。失敗したまま再生へ進むと無音になります。
iOS 27のasync版activate・deactivate
iOS 27では、有効化と無効化に非同期版のactivate(options:completionHandler:)とdeactivate(options:completionHandler:)が加わりました。どちらもasync throwsでBoolを返す形も用意されています。deactivateは「呼び出したスレッドをブロックせずにすぐ戻る」と公式に書かれています。完了を待つあいだ呼び出し元を止めたくない場面では、同期のsetActiveの代わりにこちらを使います。
@available(iOS 27.0, *)
func startPlayback(_ player: AVAudioPlayer) async {
let session = AVAudioSession.sharedInstance()
do {
try session.setCategory(.playback, mode: .default, options: [])
guard try await session.activate() else { return }
player.play()
} catch {
print("activation failed: \(error)")
}
}
戻り値のBoolがfalseになるのは、たとえばwatchOSで経路選択画面をユーザーが閉じた場合です。iOS 26以前も対象にするアプリは、従来のsetActiveとの両対応にしておきます。iOS 27の配信日や対応機種はiOS 27の配信日と対応機種・SDKの破壊的変更、ビルド環境はXcode 27の動作要件と移行点で整理しています。
終了時のnotifyOthersOnDeactivation指定
再生を終えてセッションを閉じるときは、オプションを付けます。
try? AVAudioSession.sharedInstance()
.setActive(false, options: [.notifyOthersOnDeactivation])
公式ドキュメントはこのオプションを「自分のセッションに中断されていた他のセッションが、アクティブ状態へ戻れることを示す」と説明しています。実際に再開するかは相手のアプリ次第ですが、付け忘れると戻る合図そのものが届きません。iOS 27のdeactivate(options:)でも同じnotifyOthersOnDeactivationを指定できます。もう1点、再生中のプレイヤーやエンジンを止めずに無効化すると、それらは停止させられ、isBusyエラーが返ります。プレイヤーを止めてから無効化してください。
割り込み(電話・Siri・アラーム)への対応
電話の着信やSiriの起動では、システムがオーディオセッションを中断します。後述の設定で一部の割り込みは希望を伝えられますが、すべては防げません。アプリにできるのは、止まったことを検知してUIを合わせ、終わったら適切に再開することです。AVPlayerはセッションを自分で監視して自動で一時停止するので、ここで書く処理はAVAudioPlayerやAVAudioEngineを直接動かす実装向けです。受け方はiOS 27を境に変わりました。
iOS 26以前:interruptionNotificationのbeganとended
従来の方法はinterruptionNotificationを購読し、開始(began)で停止し、終了(ended)でshouldResumeが立っていれば再開する形です。この通知はメインスレッドで届きます。
interruptionToken = NotificationCenter.default.addObserver(
forName: AVAudioSession.interruptionNotification,
object: AVAudioSession.sharedInstance(),
queue: .main
) { note in
guard let raw = note.userInfo?[AVAudioSessionInterruptionTypeKey] as? UInt,
let type = AVAudioSession.InterruptionType(rawValue: raw) else { return }
switch type {
case .began:
player.pause()
case .ended:
guard let optRaw = note.userInfo?[AVAudioSessionInterruptionOptionKey] as? UInt
else { return }
let options = AVAudioSession.InterruptionOptions(rawValue: optRaw)
guard options.contains(.shouldResume), wantsPlayback else { return }
do {
try AVAudioSession.sharedInstance().setActive(true)
player.play()
} catch {
print("failed to reactivate session: \(error)")
}
@unknown default:
break
}
}
再開の条件をshouldResumeだけにしないでください。割り込み中にユーザーが停止したり、そもそも再生していなかったりするためです。上の例では、所有クラスに再生意図(wantsPlayback)を持たせ、ユーザーの再生操作でtrue、停止・一時停止操作でfalseにします。shouldResumeが立ち、再生意図が残っているときだけ再開します。システムに止められた後のplayer.isPlayingは当てにしません。addObserverが返すトークンも所有クラスで保持し、監視をやめるときにremoveObserverへ渡します。
古い記事でよく見るAVAudioSessionInterruptionWasSuspendedKeyには注意が要ります。iOS 10以降、システムはアプリのプロセスをサスペンドするときにセッションを無効化し、アプリが再開したときに遅れてbeganが届きます。この判別に使われてきたのがWasSuspendedKeyですが、このキーはiOS 14.5で非推奨になり、代わりにAVAudioSessionInterruptionReasonKeyを使うよう案内されています。さらにその理由値のappWasSuspendedもiOS 16.0で非推奨になり、公式の表記は「wasSuspended reason no longer present」です。いま書くコードでは、この判別に頼らない設計にします。公式が勧める対策は、バックグラウンドへ移るときに音を使っていなければセッションを自分で無効化しておくことです。そうすれば、システムに無効化されて遅れた通知を受け取ることがありません。
iOS 27以降:didBecomeInactiveとresumptionRecommendation
iOS 27で、割り込みを「開始と終了」ではなく「無効化と再開の推奨」として扱う3つのライフサイクル通知が加わりました。Appleの割り込みガイドは、新しいコードではこちらを採用するよう勧め、理由を「中断中か有効かを直接表し、システムが終了イベントを届けられないときにも状態がずれない」と説明しています。従来のendedは割り込んだ側の終了合図に依存するため、それが届かないと再開できないまま止まっていました。
| 通知 | 届くタイミング | userInfoの中身 |
|---|---|---|
| didBecomeActiveNotification | セッションが有効になった | なし |
| didBecomeInactiveNotification | セッションが無効になった | DeactivationContext |
| resumptionRecommendationNotification | 再開すべきかの推奨が出た | ResumptionContext |
DeactivationContextのsourceが、無効化したのがアプリ自身(app)かシステム(system)かを示します。systemのときはinterruptionContextのreasonで理由が分かります。理由の値には、他のセッションの有効化(default)、内蔵マイクのミュート(builtInMicMuted)、経路の切断(routeDisconnected)があります。
@available(iOS 27.0, *)
@MainActor
final class PlaybackController {
let player: AVAudioPlayer
var wantsPlayback = false // 再生操作でtrue、停止操作でfalseにする
private var tasks: [Task<Void, Never>] = []
init(player: AVAudioPlayer) {
self.player = player
}
func startObserving() {
stopObserving()
tasks = [
Task { await self.observeDeactivations() },
Task { await self.observeResumption() }
]
}
func stopObserving() {
tasks.forEach { $0.cancel() }
tasks = []
}
private func observeDeactivations() async {
let session = AVAudioSession.sharedInstance()
for await note in NotificationCenter.default.notifications(
named: AVAudioSession.didBecomeInactiveNotification, object: session
) {
guard let context = note.userInfo?[AVAudioSession.deactivationContextKey]
as? AVAudioSession.DeactivationContext else { continue }
if case .system = context.source {
player.pause()
}
}
}
private func observeResumption() async {
let session = AVAudioSession.sharedInstance()
for await note in NotificationCenter.default.notifications(
named: AVAudioSession.resumptionRecommendationNotification, object: session
) {
guard let context = note.userInfo?[AVAudioSession.resumptionContextKey]
as? AVAudioSession.ResumptionContext,
context.recommendation == .shouldResume,
wantsPlayback else { continue }
do {
if try await session.activate(), wantsPlayback {
player.play()
}
} catch {
print("failed to reactivate session: \(error)")
}
}
}
}
2つの監視は別々のTaskで動かし、Taskを所有クラスで保持します。監視をやめるときは両方をcancel()し、画面の再表示などで二重に購読しないよう、開始前に既存のTaskを止めます。Swiftの型安全な通知API(NotificationCenter.MainActorMessage)を使う場合は、addObserver(of: session, for: .didBecomeInactive)でDidBecomeInactiveMessageを受け取り、deactivationResultを.appDeactivatedと.systemInterruption(let context)でパターンマッチできます。これらの通知はメインキューで届きます。
Appleのガイドは、iOS 27以降ではinterruptionNotificationとそのキー・列挙型を非推奨にすると書いています(2026年11月8日時点で、interruptionNotificationのシンボル自体には非推奨の版が付いていません)。iOS 26以前を対象に含めるアプリは、if #available(iOS 27.0, *)で新旧を分け、同じ割り込みを両方で二重に処理しないようにします。
割り込みの既定動作を変える3つの設定
既定の割り込み動作を変えたいときは、次の3つを使います。
- overrideMutedMicrophoneInterruption(iOS 14.5):iPadのSmart Folioを閉じると内蔵マイクがハードウェアでミュートされ、既定ではセッションが割り込まれる。再生と録音を両方行うアプリで再生を続けたいときに付ける
- setPrefersNoInterruptionsFromSystemAlerts(_:)(iOS 14.5):着信などのシステムアラートで割り込まれたくないという希望を伝える。あくまで希望で、優先度の高い割り込みまでは止められない
- setPrefersInterruptionOnRouteDisconnect(_:)(iOS 17.0):iOS 17から、システムは経路の切断時にNow Playingのセッションを割り込むようになった。それ以外のセッションは割り込まれないので、切断時に割り込ませたいかをこのメソッドで指定する
ルート変更とメディアサービスのリセット
イヤホンの抜き差しを検知するrouteChangeNotification
イヤホンを抜いたら再生を止めるのは、ユーザーが期待する挙動です。公式のルート変更ガイドも「ヘッドホンを外したとき、ユーザーは聴いている内容を周囲に共有したいわけではない。アプリはこの暗黙のプライバシー要求を尊重し、自動的に再生を一時停止すべき」としています。AVPlayerはこれを自前で行うので、AVPlayerを使う場合はrateプロパティをKVOで監視してUIを合わせるだけです。AVAudioPlayerやAVAudioEngineを直接動かす実装では、routeChangeNotificationのreasonがoldDeviceUnavailableのときに自分で止めます。
routeToken = NotificationCenter.default.addObserver(
forName: AVAudioSession.routeChangeNotification,
object: nil,
queue: nil
) { note in
guard let raw = note.userInfo?[AVAudioSessionRouteChangeReasonKey] as? UInt,
let reason = AVAudioSession.RouteChangeReason(rawValue: raw) else { return }
if reason == .oldDeviceUnavailable {
DispatchQueue.main.async { player.pause() }
}
}
queueにnilを渡すと、通知は投稿されたスレッドでそのまま処理されます。ルート変更通知はセカンダリスレッドで届くので、プレイヤーやUIを触る処理はメインスレッドへ戻します。reasonには他にnewDeviceAvailable(イヤホンを挿した等)、categoryChange、override、wakeFromSleep、noSuitableRouteForCategory、routeConfigurationChange、unknownがあり、直前の経路はAVAudioSessionRouteChangePreviousRouteKeyから取得できます。
メディアサービスのリセット後のオブジェクト再生成とセッション再設定
まれに、システムはメディアサービスのデーモンを終了して再起動します。このとき届くのがmediaServicesWereResetNotificationで、公式ドキュメントは「プレイヤー・レコーダー・コンバーター・オーディオキューなどのオーディオオブジェクトを作り直し、セッションのカテゴリ・オプション・モードを設定し直す」よう求めています。
resetToken = NotificationCenter.default.addObserver(
forName: AVAudioSession.mediaServicesWereResetNotification,
object: nil,
queue: .main
) { _ in
rebuildAudioObjects()
configureAudioSession()
}
作り直すのはオーディオオブジェクトとセッションの設定だけで、通知の購読とセッションのプロパティへのKVOは登録し直す必要がありません。また、再生や録音はユーザーの操作があるまで再開しないことも公式の指示です。この処理は、iOSの設定アプリの「デベロッパ」メニューにある「Reset Media Services」で意図的に発生させて確かめられます。
通知ごとの届くスレッド
AVAudioSessionの通知は、種類によって届くスレッドが違います。queueにnilで購読する場合、ルート変更の中でUIを触るならメインスレッドへ戻す必要があります。
| 通知 | 届くスレッド | 追加 |
|---|---|---|
| interruptionNotification | メインスレッド | iOS 6.0 |
| routeChangeNotification | セカンダリスレッド | iOS 6.0 |
| mediaServicesWereResetNotification | メインスレッド | iOS 6.0 |
| mediaServicesWereLostNotification | メインスレッド | iOS 7.0 |
| silenceSecondaryAudioHintNotification | メインスレッド | iOS 8.0 |
| didBecomeActive / didBecomeInactive / resumptionRecommendation | メインキュー | iOS 27.0 |
入力デバイス・出力先とエコーキャンセル
setPreferredInputとoverrideOutputAudioPortの使い分け
マイクを選ぶにはsetPreferredInput(_:)、スピーカーへ一時的に切り替えるにはoverrideOutputAudioPort(_:)を使います。setPreferredInput(_:)に渡す候補は、録音できるカテゴリを設定してセッションを有効化したあと、availableInputsから取得します。カテゴリを設定する前に読んでも候補は揃いません。
overrideOutputAudioPortについて、公式ドキュメントは「効果は現在の経路が変わるか、noneを指定して再度呼ぶまでしか続かない。恒久的に有効にしたいならdefaultToSpeakerを設定すること」と明記しています。通話画面のスピーカーボタンのような一時的な切り替えはoverrideOutputAudioPort、受話口ではなく内蔵スピーカーを既定の出力にしたいならdefaultToSpeakerです。ヘッドホン接続中の扱いは、Webの公式ドキュメント(接続中もスピーカーのまま)とSDKのヘッダー(他の経路が無いときにスピーカー)で記述が分かれているので、対象のOSと機器で確かめてください。また、setPreferredInput(_:)でBluetooth HFPの入力を選ぶと出力もHFPへ変わり、逆に経路選択画面でHFP出力を選ぶと入力もHFPに変わります。入力と出力を別々に選ぶことはできません。
iOS 18.2のエコーキャンセル入力とiOS 26の出力ミュート
内蔵スピーカーで音を鳴らしながら内蔵マイクで録る場合、iOS 18.2からはsetPrefersEchoCancelledInput(_:)でスピーカーの音を消した入力を求められます。条件は厳しく、playAndRecordカテゴリとdefaultモードの組み合わせで、2024年以降の一部のiPhoneに限られます。対応しているかはisEchoCancelledInputAvailableで確かめ、有効化したあとisEchoCancelledInputEnabledで実際に効いたかを見ます。
let session = AVAudioSession.sharedInstance()
try session.setCategory(.playAndRecord, mode: .default, options: [.defaultToSpeaker])
if #available(iOS 18.2, *), session.isEchoCancelledInputAvailable {
try session.setPrefersEchoCancelledInput(true)
}
try session.setActive(true)
Voice I/Oなど音声処理APIを使うセッションには、システムが自動でエコーキャンセルを掛けるので、このオプションは要りません。公式は違いを「音声処理は声に合わせて調整されているが、このオプションはより広い種類の音を拾えるよう調整されている」と説明しています。楽器の演奏アプリやカラオケのように声以外も録るアプリが対象です。ヘッドセットへ経路が変わると無効になる場合がある点も注記されています。
iOS 26では、セッション単位で出力をミュートするsetOutputMuted(_:)とisOutputMutedが加わりました。playAndRecordではdefaultモードのときだけ使え、システムのサウンドと触覚フィードバックは消えません。ミュート中にユーザーが音量ボタンを操作すると、userIntentToUnmuteOutputNotificationで「ミュートを解除したい」という意図が届きます。
バックグラウンド再生とマイク権限
バックグラウンド再生に必要なUIBackgroundModesのaudio値
カテゴリをplaybackにすればサイレントスイッチと画面ロックを無視して鳴りますが、それだけでは足りません。公式ドキュメントはplayback・playAndRecord・recordの各カテゴリの説明で、同じ条件を挙げています。バックグラウンドへ移行したとき(たとえば画面がロックされたとき)に再生(recordでは録音)を続けるには、「情報プロパティリストのUIBackgroundModesキーにaudioの値を追加すること」です。
<key>UIBackgroundModes</key>
<array>
<string>audio</string>
</array>
Xcodeでは、ターゲットのSigning & CapabilitiesからBackground Modesを追加し、Audio, AirPlay, and Picture in Pictureにチェックを入れると同じ内容が書き込まれます。バックグラウンドで録音を続ける場合も同じaudio値を使います。バックグラウンドで音声を扱わないアプリでは外しておきます。
iOS 17以降の録音許可とAVAudioApplication
録音許可の取得は、長くAVAudioSession.sharedInstance().requestRecordPermission(_:)が使われてきました。公式ドキュメントは、このメソッドとrecordPermissionプロパティの両方についてiOS 17で非推奨とし、AVAudioApplicationの同等APIを使うよう案内しています。iOS 17で追加されたAVAudioApplicationは、アプリに属するオーディオセッションを束ねて管理するクラスで、録音許可の取得と状態確認、入力ミュートを担当します。
import AVFAudio
switch AVAudioApplication.shared.recordPermission {
case .granted:
startRecording()
case .denied:
showSettingsGuidance()
case .undetermined:
AVAudioApplication.requestRecordPermission { granted in
DispatchQueue.main.async {
granted ? startRecording() : showSettingsGuidance()
}
}
@unknown default:
break
}
許可を求める前提として、Info.plistにNSMicrophoneUsageDescriptionで利用目的を書きます。Appleはこのキーを「デバイスのマイクにアクセスするAPIを使う場合は必須」としており、保護されたリソースへのアクセスの解説では、目的の文字列が無いとアクセスは失敗し、アプリがクラッシュすることもあると書いています。許可の状態はアプリごとに保存され、一度deniedになると同じアプリではダイアログが再表示されません。この場合は設定アプリへの導線を出します。
AVAudioApplicationには、通話に音声を差し込む権限を扱うrequestMicrophoneInjectionPermission(completionHandler:)と、アプリ単位の入力ミュートを扱うisInputMuted・setInputMuted(_:)・inputMuteStateChangeNotificationもあります。会議アプリのミュートボタンをアプリ全体に反映したいなら、こちらを使います。録った音声をそのまま文字にしたい場合は、Appleのオンデバイス音声認識API SpeechAnalyzerと組み合わせられます。
音が出ない・録音できないときの切り分け
症状ごとに、最初に疑う設定をまとめます。
| 症状 | 確認する点 | 対処 |
|---|---|---|
| まったく音が出ない | カテゴリがrecordでないか | playbackかplayAndRecordへ |
| サイレント時だけ出ない | ambient / soloAmbientか | playbackへ変更 |
| 耳に当てないと聞こえない | playAndRecordで受話口へ出ている | defaultToSpeaker |
| ロックすると止まる | UIBackgroundModesにaudioがあるか | Info.plistへ追加 |
| 録音ファイルが無音 | 再生専用カテゴリか、許可がdeniedか | playAndRecord・設定へ誘導 |
| Bluetoothマイクが選べない | allowBluetoothHFPがあるか | playAndRecord / recordで指定 |
| 電話の後に再生が戻らない | 割り込みを受けているか | iOS 27はresumptionRecommendation |
| 他アプリの音楽が再開しない | 無効化時のオプション | notifyOthersOnDeactivation |
| 突然すべての音が止まった | メディアサービスのリセット | オブジェクトと設定を作り直す |
「音が出ない」で見落としやすいのは、setActive(true)が実際には失敗しているケースです。try?で握りつぶしていると気づけないので、切り分け中は一度do-catchに変えてエラーを表示してください。録音側では、通話中にサードパーティアプリがマイクを使えない点と、Bluetooth機器が接続されていると内蔵マイクが選ばれない点が定番の原因です。どのマイクが使われているかは、currentRouteのinputsで確認できます。
通話・録音・バックグラウンド再生が絡むアプリは、OSの更新ごとに割り込みと経路変更の挙動を見直す必要があります。設計から任せたい場合はiOSアプリ開発の受託・支援をご覧ください。
よくある質問
AVAudioSessionのsetActiveはいつ呼べばよいですか?
カテゴリとモードは起動時に設定し、setActive(true)は実際に再生や録音を始める直前に呼びます。playbackなどミックス不可のカテゴリでは、有効化した時点で他アプリの音楽が止まるためです。有効化後にカテゴリを変えることもできますが、即座に反映されて経路が切り替わり、音が途切れることがあります。iOS 27以降は、メインスレッドを止めないasync版のactivate()も使えます。
playbackとplayAndRecordはどちらを選ぶべきですか?
マイクを使わないならplaybackです。playAndRecordは既定で受話口から音が出るため、スピーカーで鳴らすにはdefaultToSpeakerの指定が別に要ります。再生だけのアプリでplayAndRecordを選ぶ理由はありません。
requestRecordPermissionはもう使えないのですか?
コンパイルは通りますが、AVAudioSession側のrequestRecordPermission(_:)とrecordPermissionはiOS 17で非推奨です。新規実装ではAVAudioApplication.requestRecordPermission(completionHandler:)とAVAudioApplication.shared.recordPermissionを使います。
allowBluetoothとallowBluetoothHFPはどちらを書けばよいですか?
新しく書くコードではallowBluetoothHFPです。Apple公式ドキュメントのallowBluetoothにはallowBluetoothHFPへの改称が記録されています。指定できるのは入力を扱うカテゴリで、playAndRecordとrecord、それにdualRouteモードと組み合わせたmultiRouteです。
mixWithOthersとduckOthersの違いは何ですか?
mixWithOthersは他アプリの音量をそのままにして自分の音を重ね、duckOthersは他アプリの音量を下げます。公式ドキュメントによれば、ダッキングの期間は「セッションを有効化したときに始まり、無効化したときに終わる」で、自分が音を出している区間ではありません。ナビの案内のように数秒だけ下げたいなら、案内のたびにセッションを有効化・無効化します。
AVAudioSessionはmacOSでも使えますか?
使えません。対応プラットフォームはiOS・iPadOS・Mac Catalyst・tvOS・visionOS・watchOSで、macOSは含まれていません。iPadアプリをMac Catalystで動かす場合は使えますが、ネイティブのmacOSアプリでは入出力の制御をCore Audioで行います。