您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

TheAmazingAudioEngine 實戰:iOS 音頻播放、錄制與音效處理

編輯:iOS 開發基礎

受標題字數限制,本文原標題為《iOS 第三方音頻框架 TheAmazingAudioEngine 使用及音效實現介紹》。

概述

TheAmazingAudioEngine 是 Michael Tyson 開源的 iOS 音頻框架,不少音頻類 App 都用它做底層支撐。借助它,音頻開發中那些原本繁瑣的音效需求會變得相當容易實現。

iOS 開發中的音頻框架

先放一張整理圖,方便理解 iOS 各音頻框架之間的結構關係(依 Apple 官方文件《Using Audio》與 objc 中國《音頻 API 一覽》整理,如有謬誤歡迎指正)。

TheAmazingAudioEngine 本質上就是對 AudioUnit、AudioToolBox、AVFoundation 三層的封裝,把底層介面收斂成更好用的高階 API。

音頻播放

這部分和官方的 AVAudioPlayer、AVAudioEngine 思路相近:拿到檔案路徑或音頻 buffer,呼叫相應方法即可。以檔案播放為例,步驟是:

  • 建立 AEAudioController 物件;
  • 取得音頻路徑(NSURL);
  • 依路徑建立 AEAudioFilePlayer;
  • 用 AEAudioController 的 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];
}

音頻錄制

普通錄制(錄完再播)

步驟:

  • 建立 AERecorder 物件;
  • 取得錄音檔的保存路徑;
  • 用 AEAudioController 的 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,這個框架提供的音效更豐富,接入也更直觀。通用三步:

  • 建立 AEAudioUnitFilter 或其子類物件;
  • 用 AEAudioController 的 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 調整

因為對音頻領域的概念不熟,做 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 用在音頻播放、錄制與音效處理上的一次實踐記錄。這個框架能做的事遠不止這些,有興趣的朋友可以繼續往下挖。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved