使用 AVAudioPlayer 來播放音樂

AVAudioPlayer 是在 iOS 裝置中用來播放音樂的一個重要類別，它被包含在 AVFoundation.framework 套件中，透過 AVAudioPlayer 我們除了可以播放音樂之外，還可以取得正在播放的音軌位置、聲音大小或是聲道數目等等，因此，它常被使用來製作音樂撥放器等相關的應用程式。如果你想尋找的是播放單純的「音效」而非「音樂」，請參考 Core Audio 的 System Sound 音效播放一文。

環境設定
既然 AVAudioPlayer 是包含在 AVFoundation.framework 之中，在使用上就別忘了把函式庫和 Framework 加到專案中，對於新增 Framework 有問題的讀者們，請參考 Xcode 4 新增 Framework 的方法一文。

#import <AVFoundation/AVAudioPlayer.h>

替專案增加 AVFoundation.framework

接著在實作類別中的 @interface 區段中，建立一個 AVAudioPlayer 型態的全域變數，方便稍後用它來實作播放音樂的總總功能。

AVAudioPlayer *myPlayer;

ps:在類別的 import 上，你可以選擇只匯入關鍵的 AVAudioPlayer.h（如上述的程式碼），或是直接使用 AVFoundation/AVFoundation.h 將整個 AVFoundation.framework 中所有的套件都一次匯入。

載入音樂
在這個部分，我們要將先前宣告的 myPlayer 全域變數與音樂檔案做連結，當然，如果你的音樂檔案不再本機端而是存放於網路，你也可以透過連結網路位置的方式來播放音樂檔案（並非音樂串流）。
//檔案存放於本機
//取得播放檔案的位置
NSURL* url = [[NSURL alloc] initFileURLWithPath:[[NSBundle mainBundle] pathForResource:@"FileName" ofType:@"mp3"]];

//與音樂檔案做連結
NSError* error = nil;
myPlayer = [[AVAudioPlayer alloc] initWithContentsOfURL:url error:&error];

if (!url || error) {
    //錯誤處理常式
}
//檔案存放於網路
//取得播放檔案的位置
NSURL *url = [NSURL URLWithString:@"http://FileName.mp3"];
NSData *myNetworkData = [NSData dataWithContentsOfURL:url];

//與音樂檔案做連結
NSError* error = nil;
myPlayer = [[AVAudioPlayer alloc] initWithData:myNetworkData error:&error];

if (!url || error) {
    //錯誤處理常式
}

控制項目與檔案資訊

AVAudioPlayer 的控制項目包含「播放」、「暫停」、「跳轉」與「音量控制」等等，另外在資訊的部份像是「音軌總長度」、「目前播放位置」或是「聲道數目」等等都可以透過 AVAudioPlayer 來取得檔案的相關資訊。

//設定音量0.0~1.0
[myPlayer setVolume:0.5];

//設定播放次數-1為無限循環
[myPlayer setNumberOfLoops:0];

//設定播放位置（重頭播放）
[myPlayer setCurrentTime:0.0];

//播放
[myPlayer play];

//暫停
[myPlayer pause];

//停止
[myPlayer stop];

//相關資訊
NSLog(@"音樂總長度 %f", [myPlayer duration]);
NSLog(@"目前播放位置 %f", [myPlayer currentTime]);
NSLog(@"聲道數目 %d", [myPlayer numberOfChannels]);

你可以自行組合上述這些控制項目來實作簡單的控制應用，像是暫停/播放或是往後快轉數秒的按鈕等等。

//暫停/播放
if ([myPlayer isPlaying]) {
    [myPlayer pause];
} else {
    [myPlayer play];
}
//往後跳轉1秒
NSTimeInterval currentTime = [myPlayer currentTime];
[myPlayer setCurrentTime:currentTime + 1];

AVAudioPlayerDelegate 協定

在 AVAudioPlayer 的類別中的 AVAudioPlayerDelegate 協定，可以幫助我們捕捉音樂在播放完成時的那個瞬間，也就是當音樂播放完成時（不論成功與否）都會觸發此協定中所定義的方法函式。

- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag {
    NSLog(@"播放完畢");
}

另外，在 AVAudioPlayerDelegate 協定之中，還有兩個比較常用的方法函式，像是當電話來時，音樂被強迫中斷，或是當結束通話時恢復音樂播放的瞬間，我們都可以透過下列兩個方法函式來捕捉（需使用實體裝置執行時才會生效）。

//電話中斷
- (void)audioPlayerBeginInterruption:(AVAudioPlayer *)player {
    NSLog(@"被中斷");
}
- (void)audioPlayerEndInterruption:(AVAudioPlayer *)player withOptions:(NSUInteger)flags {
    NSLog(@"從中斷中恢復");
}

在使用上，你必須先替實作的類別的 @interface 區段上加上 <AVAudioPlayerDelegate>，並且在程式碼中使用 setDelegate 來決定要實作的位置，關於協定的相關資訊請參考Protocol 協定的使用方式一文。

背景執行（模擬器無法使用）

想要讓音樂能夠在背景執行，必須要具備 iOS 4.0 以上的條件，你可以參考偵測 Device 是否支援多工或背景執行的方法一文，來判斷目前的裝置是否能夠支援此項功能。

在實作上，首先必須先到專案的 info.plist 中增加背景執行的權限 Required background modes，並設定執行的類別為 App plays audio，如下圖。

替專案增加背景執行的權限

接著，替專案的 AVAudioSession 做以下設定（在此必須記得 import AVAudioSession.h，如果你先前已經將整個 AVFoundation.h 都匯入，則可以省略此步驟）。

NSError* error = nil;
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:&error];
if (error) {
    //錯誤處理常式
}

error = nil;
[[AVAudioSession sharedInstance] setActive:YES error:&error];
if (error) {
    //錯誤處理常式
}


你可以在任何地方安插上述程式碼，但是，必須確保此程式碼在應用程式進入背景作業之前就會被執行到，另外，你可以參考使用 Remote Control 來控制退至背景播放的音樂一文，來控制背景執行中的音樂。

ps:其他有關 AVAudioPlayer 類別的相關資訊，請參考 iOS Developer Library 官方網站。