iOS 的多媒體播放有幾條不同的技術路線,本文聚焦在兩個實用元件:負責播放影片的 MPMoviePlayerController,以及讓使用者從音樂庫挑選音訊的 MPMediaPickerController。兩者都屬於 MediaPlayer 框架,使用方式相當直覺。
MPMoviePlayerController 與 AVAudioPlayer 有點類似——前者播影片,後者播音訊。但存在一個關鍵差異:MPMoviePlayerController 可以直接用遠端 URL 初始化,AVAudioPlayer 則不行。除此之外,整體使用手感相當接近。
支援格式方面,MPMoviePlayerController 可播放 MOV、MP4、M4V、3GP 等影片格式,以及多種常見音訊格式。
使用前請先引入 MediaPlayer.framework,並在相關檔案中 #import <MediaPlayer/MediaPlayer.h>。
MPMoviePlayerController 透過 initWithContentURL: 初始化,傳入的 URL 可以是遠端也可以是本地:
// 遠端 URL
MPMoviePlayerController *moviePlayer =
[[MPMoviePlayerController alloc] initWithContentURL:[NSURL URLWithString:@"https://..."]];
// 本地檔案
NSString *path = [NSString stringWithFormat:@"%@/Documents/video.3gp", NSHomeDirectory()];
MPMoviePlayerController *moviePlayer =
[[MPMoviePlayerController alloc] initWithContentURL:[NSURL fileURLWithPath:path]];
注意本地路徑要用 fileURLWithPath: 而非 URLWithString:,這是最常見的入門錯誤之一。
1. 控制器樣式
moviePlayer.movieControlMode = MPMovieControlModeDefault;
可選值有三種:
2. 畫面縮放模式
moviePlayer.scalingMode = MPMovieScalingModeAspectFit;
3. 背景顏色
背景色會在播放器轉入轉出時使用,當影片沒填滿整個螢幕時,也會用來填補空白區域。預設是黑色,可自行調整:
moviePlayer.backgroundColor = [UIColor redColor];
呼叫 play 後,播放控制器會自動把視圖切換到全螢幕播放模式並開始播放:
[moviePlayer play];
停止有兩種途徑:使用者點擊 Done 按鈕,或程式呼叫 stop:
[moviePlayer stop];
停止播放後,系統會自動切回播放前的應用程式視圖。
播放器會把重要事件拋到 Cocoa 的通知中心,包括內容預載完成、播放結束、縮放模式變更等。註冊觀察者即可接收:
NSNotificationCenter *notificationCenter = [NSNotificationCenter defaultCenter];
[notificationCenter addObserver:self
selector:@selector(moviePlayerPreloadDidFinish:)
name:MPMoviePlayerContentPreloadDidFinishNotification
object:moviePlayer];
對應的回呼方法:
- (void)moviePlayerPreloadDidFinish:(NSNotification *)notification {
// 在這裡寫你的處理邏輯
}
值得監聽的三個通知:
MPMediaPickerController 的用法與 UIImagePickerController 幾乎一致,差別在於它瀏覽的是系統音樂庫,可讓使用者挑選音樂、播客或有聲書。
1. 建立與設定
MPMediaPickerController *mpc = [[MPMediaPickerController alloc] initWithMediaTypes:MPMediaTypeMusic]; mpc.delegate = self; // 設定代理 mpc.prompt = @"Please select a music"; // 提示文字 mpc.allowsPickingMultipleItems = NO; // 是否允許一次選多個
初始化時傳入的媒體類型參數可從下列列舉中挑選:
enum {
// 音訊類
MPMediaTypeMusic = 1 << 0,
MPMediaTypePodcast = 1 << 1,
MPMediaTypeAudioBook = 1 << 2,
MPMediaTypeAudioITunesU = 1 << 3, // iOS 5.0 起可用
MPMediaTypeAnyAudio = 0x00ff,
// 影片類(iOS 5.0 起可用)
MPMediaTypeMovie = 1 << 8,
MPMediaTypeTVShow = 1 << 9,
MPMediaTypeVideoPodcast = 1 << 10,
MPMediaTypeMusicVideo = 1 << 11,
MPMediaTypeVideoITunesU = 1 << 12,
MPMediaTypeAnyVideo = 0xff00,
MPMediaTypeAny = ~0
};
typedef NSInteger MPMediaType;
2. 代理方法
// 使用者完成選取
- (void)mediaPicker:(MPMediaPickerController *)mediaPicker
didPickMediaItems:(MPMediaItemCollection *)mediaItemCollection {
// 在這裡處理選到的內容
for (MPMediaItem *item in [mediaItemCollection items]) {
// 逐一取出屬性
}
[self dismissModalViewControllerAnimated:YES];
[mediaPicker release];
}
// 使用者取消選取
- (void)mediaPickerDidCancel:(MPMediaPickerController *)mediaPicker {
[self dismissModalViewControllerAnimated:YES];
[mediaPicker release];
}
3. 顯示選擇器
[self presentModalViewController:mpc animated:YES];
4. 一個容易卡住的地方
很多人看完範例仍然霧裡看花,原因通常在第一個回呼方法的參數型別。MPMediaItemCollection 的 items 屬性就是用戶所選項目的集合,每個元素都是 MPMediaItem 的實例,可透過 valueForProperty: 查詢標題、演出者、專輯、播放時長、資產 URL 等大量屬性。由於屬性眾多,建議直接查閱 MPMediaItem 的標頭檔或官方文件,選幾個用得到的即可。