受標題字數限制,本文原標題為《iOS 第三方音頻框架 TheAmazingAudioEngine 使用及音效實現介紹》。
TheAmazingAudioEngine 是 Michael Tyson 開源的 iOS 音頻框架,不少音頻類 App 都用它做底層支撐。借助它,音頻開發中那些原本繁瑣的音效需求會變得相當容易實現。
先放一張整理圖,方便理解 iOS 各音頻框架之間的結構關係(依 Apple 官方文件《Using Audio》與 objc 中國《音頻 API 一覽》整理,如有謬誤歡迎指正)。

TheAmazingAudioEngine 本質上就是對 AudioUnit、AudioToolBox、AVFoundation 三層的封裝,把底層介面收斂成更好用的高階 API。
這部分和官方的 AVAudioPlayer、AVAudioEngine 思路相近:拿到檔案路徑或音頻 buffer,呼叫相應方法即可。以檔案播放為例,步驟是:
addChannels: 把 player 掛進去。#pragma mark - 音頻播放
- (void)playNewSongCH1:(NSURL *)songURL {
if (_selectedSongCH1Player) {
[_audioController removeChannels:@[_selectedSongCH1Player]];
_selectedSongCH1Player = nil;
}
// 建立 AEAudioFilePlayer
_selectedSongCH1Player = [[AEAudioFilePlayer alloc] initWithURL:songURL error:nil];
// 開始播放
[_audioController addChannels:@[_selectedSongCH1Player]];
}檔案路徑的取得有兩種常見情形。如果是直接拖進工程內部的資源,用檔名與副檔名組 NSURL 就好:
static NSString *audioFileName = @"leftRightTest";
static NSString *audioFileFormat = @"mp3";
NSURL *songURL = [[NSBundle mainBundle] URLForResource:audioFileName
withExtension:audioFileFormat];如果想播放手機裡的曲目,則透過 MPMediaPickerController 的代理方法取得:
#pragma mark - MPMediaPickerControllerDelegate
- (void)mediaPicker:(MPMediaPickerController *)mediaPicker
didPickMediaItems:(MPMediaItemCollection *)mediaItemCollection {
if (mediaPicker == _mediaCH1PickerController) {
// representativeItem.assetURL 即使用者所選歌曲的 URL
// 這裡已把播放邏輯封裝進自訂的 engine 類
[[HNMCManager shareManager].engine playNewSongCH1:mediaItemCollection.representativeItem.assetURL];
} else {
[[HNMCManager shareManager].engine playNewSongCH2:mediaItemCollection.representativeItem.assetURL];
}
[self dismissViewControllerAnimated:YES completion:nil];
}步驟:
addInputReceiver:(錄麥克風)或 addOutputReceiver:(錄手機喇叭輸出)把 recorder 掛進去。static NSString *ch1RecorderFileName = @"ch1Recording.m4a";
#pragma mark - 開始錄音
- (void)setupCH1RecorderBeginRecording {
_ch1Recorder = [[AERecorder alloc] initWithAudioController:_audioController];
NSString *filePath = [self getFilePathWithFileName:ch1RecorderFileName];
NSError *error = nil;
if (![_ch1Recorder beginRecordingToFileAtPath:filePath
fileType:kAudioFileM4AType
error:&error]) {
return;
}
// 同時錄下輸入與輸出通道,也就是人聲與 App 播放的聲音都收進來
[_audioController addInputReceiver:_ch1Recorder];
[_audioController addOutputReceiver:_ch1Recorder];
}
#pragma mark - Helper
- (NSString *)getFilePathWithFileName:(NSString *)fileName {
NSString *documentsFolder =
[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
return [documentsFolder stringByAppendingPathComponent:fileName];
}
#pragma mark - 停止錄音
- (void)stopCH1Recording {
if (_ch1Recorder) {
[_ch1Recorder finishRecording];
[_audioController removeInputReceiver:_ch1Recorder];
[_audioController removeOutputReceiver:_ch1Recorder];
_ch1Recorder = nil;
}
}回放錄音時,同樣用 AEAudioFilePlayer 掛到 channel 上,並可透過 completionBlock 做收尾通知:
#pragma mark - 播放錄音
- (void)playRecordCH1 {
NSString *filePath = [self getFilePathWithFileName:ch1RecorderFileName];
if (![[NSFileManager defaultManager] fileExistsAtPath:filePath]) {
return;
}
NSError *error = nil;
_ch1RecorderPlayer = [[AEAudioFilePlayer alloc] initWithURL:[NSURL fileURLWithPath:filePath]
error:&error];
if (!_ch1RecorderPlayer) {
// 播放啟動失敗的提示
return;
}
__weak HNAudioEngine *weakSelf = self;
_ch1RecorderPlayer.completionBlock = ^{
weakSelf.ch1RecorderPlayer = nil;
[[NSNotificationCenter defaultCenter] postNotificationName:kNotificationPlayRecordCH1Completed
object:nil];
};
[_audioController addChannels:@[_ch1RecorderPlayer]];
}框架裡的 AEPlaythroughChannel 可以很輕鬆地做到邊錄邊播。想像一下:把手機接上音箱,它就成了一支擴音器(當然,實際上還要處理噪音與回響)。程式碼非常短:
#pragma mark - 同步錄播(邊錄邊播)
- (void)setupCH1playthroughChannelBeginRecording {
_ch1playthroughChannel = [[AEPlaythroughChannel alloc] init];
[_audioController addInputReceiver:_ch1playthroughChannel]; // 錄
[_audioController addChannels:@[_ch1playthroughChannel]]; // 播
}
#pragma mark - 設置音量
- (void)setupCH1playthroughChannelVolume:(double)volume {
if (_ch1playthroughChannel) {
_ch1playthroughChannel.volume = volume;
}
}
#pragma mark - 停止
- (void)stopCH1Playthrough {
if (_ch1playthroughChannel) {
[_audioController removeInputReceiver:_ch1playthroughChannel];
[_audioController removeChannels:@[_ch1playthroughChannel]];
_ch1playthroughChannel = nil;
}
}所有音效都建立在 AEAudioUnitFilter 之上。相比官方的 AVAudioEngine,這個框架提供的音效更豐富,接入也更直觀。通用三步:
addFilter: 掛上去;框架已內建高通類:
#pragma mark - 高通音效
- (void)setupFilterHighPass:(double)cutoffFrequency {
[self addHighpassFilter];
_highPassFilter.cutoffFrequency = cutoffFrequency;
}
- (void)addHighpassFilter {
// AEHighPassFilter 是 AEAudioUnitFilter 的子類
if (!_highPassFilter) {
_highPassFilter = [[AEHighPassFilter alloc] init];
[_audioController addFilter:_highPassFilter];
} else {
if (![_audioController.filters containsObject:_highPassFilter]) {
[_audioController addFilter:_highPassFilter];
}
}
}因為對音頻領域的概念不熟,做 EQ 頗花了些功夫。目標介面大致如下:

實現方式是 AEParametricEqFilter,同樣是 AEAudioUnitFilter 的子類。要做 10 段 EQ,就建立 10 個物件,把 centerFrequency 設在 20Hz 到 20000Hz 之間(取決於要調哪個頻段),再透過 gain 屬性調整增益,範圍 -20dB 到 20dB。
#pragma mark - EQ 音效
// 建立 10 個 AEParametricEqFilter
- (void)creatEqFliters {
_eq20HzFilter = [[AEParametricEqFilter alloc] init];
_eq50HzFilter = [[AEParametricEqFilter alloc] init];
_eq100HzFilter = [[AEParametricEqFilter alloc] init];
_eq200HzFilter = [[AEParametricEqFilter alloc] init];
_eq500HzFilter = [[AEParametricEqFilter alloc] init];
_eq1kFilter = [[AEParametricEqFilter alloc] init];
_eq2kFilter = [[AEParametricEqFilter alloc] init];
_eq5kFilter = [[AEParametricEqFilter alloc] init];
_eq10kFilter = [[AEParametricEqFilter alloc] init];
_eq20kFilter = [[AEParametricEqFilter alloc] init];
_eqFilters = @[_eq20HzFilter, _eq50HzFilter, _eq100HzFilter, _eq200HzFilter, _eq500HzFilter,
_eq1kFilter, _eq2kFilter, _eq5kFilter, _eq10kFilter, _eq20kFilter];
}
- (void)setupFilterEq:(NSInteger)eqType value:(double)gain {
switch (eqType) {
case EQ_20Hz:
[self setupEqFilter:_eq20HzFilter centerFrequency:20 gain:gain];
break;
case EQ_50Hz:
[self setupEqFilter:_eq50HzFilter centerFrequency:50 gain:gain];
break;
case EQ_100Hz:
[self setupEqFilter:_eq100HzFilter centerFrequency:100 gain:gain];
break;
case EQ_200Hz:
[self setupEqFilter:_eq200HzFilter centerFrequency:200 gain:gain];
break;
case EQ_500Hz:
[self setupEqFilter:_eq500HzFilter centerFrequency:500 gain:gain];
break;
case EQ_1K:
[self setupEqFilter:_eq1kFilter centerFrequency:1000 gain:gain];
break;
case EQ_2K:
[self setupEqFilter:_eq2kFilter centerFrequency:2000 gain:gain];
break;
case EQ_5K:
[self setupEqFilter:_eq5kFilter centerFrequency:5000 gain:gain];
break;
case EQ_10K:
[self setupEqFilter:_eq10kFilter centerFrequency:10000 gain:gain];
break;
case EQ_20K:
[self setupEqFilter:_eq20kFilter centerFrequency:20000 gain:gain];
break;
}
}
- (void)setupEqFilter:(AEParametricEqFilter *)eqFilter
centerFrequency:(double)centerFrequency
gain:(double)gain {
if (![_audioController.filters containsObject:eqFilter]) {
for (AEParametricEqFilter *existEqFilter in _eqFilters) {
if (eqFilter == existEqFilter) {
[_audioController addFilter:eqFilter];
break;
}
}
}
eqFilter.centerFrequency = centerFrequency;
eqFilter.qFactor = 1.0;
eqFilter.gain = gain;
}以上就是把 TheAmazingAudioEngine 用在音頻播放、錄制與音效處理上的一次實踐記錄。這個框架能做的事遠不止這些,有興趣的朋友可以繼續往下挖。