MPMoviePlayerController 與 AVAudioPlayer 有幾分相似——一個放影片、一個播音訊——但關鍵差異在於:前者可以直接用遠端 URL 初始化,後者不行。使用方式上兩者都算直覺。
支援格式:MOV、MP4、M4V、3GP 等影片格式,以及多種音訊格式。使用前請先匯入 MediaPlayer.framework,並在需要的檔案中引入對應標頭檔。
建立播放器
以 NSURL 初始化,本機與遠端皆可:
// 遠端
MPMoviePlayerController *moviePlayer =
[[MPMoviePlayerController alloc] initWithContentURL:[NSURL URLWithString:@"https://..."]];
// 本機
NSString *path = [NSString stringWithFormat:@"%@/Documents/video.3gp", NSHomeDirectory()];
MPMoviePlayerController *moviePlayer =
[[MPMoviePlayerController alloc] initWithContentURL:[NSURL fileURLWithPath:path]];
屬性設定
控制器樣式:
moviePlayer.movieControlMode = MPMovieControlModeDefault; MPMovieControlModeDefault // 顯示播放/暫停、音量與時間控制 MPMovieControlModeVolumeOnly // 只顯示音量控制 MPMovieControlModeHidden // 不顯示控制器
縮放模式:
moviePlayer.scalingMode = MPMovieScalingModeAspectFit; MPMovieScalingModeNone // 不縮放 MPMovieScalingModeAspectFit // 等比縮放並完整顯示 MPMovieScalingModeAspectFill // 等比縮放並填滿,可裁切 MPMovieScalingModeFill // 填滿螢幕,不維持比例
背景色:轉場期間或影片未填滿螢幕時,會以此色填充空白區域,預設為黑色。
moviePlayer.backgroundColor = [UIColor redColor];
播放與停止
[moviePlayer play]; // 播放,並自動切換到全螢幕播放視圖 [moviePlayer stop]; // 停止,播放結束後自動切回原本的視圖
使用者按下 Done 也會停止播放。
通知
播放器會把各類事件拋到通知中心,你可以指定接收的物件與方法:
NSNotificationCenter *notificationCenter = [NSNotificationCenter defaultCenter];
[notificationCenter addObserver:self
selector:@selector(moviePlayerPreloadFinish:)
name:MPMoviePlayerContentPreloadDidFinishNotification
object:moviePlayer];
-(void)moviePlayerPreloadDidFinish:(NSNotification *)notification {
// 處理預載完成的後續動作
}
值得關注的三個通知:
1. MPMoviePlayerContentPreloadDidFinishNotification:內容預載完成。由於播放器在部分載入的情況下就能開始播放,這個通知有可能在播放開始之後才送達。
2. MPMoviePlayerScalingModeDidChangedNotification:使用者切換了縮放模式,例如在全螢幕與視窗播放之間切換。
3. MPMoviePlayerPlaybackDidFinishNotification:播放結束,或使用者按下 Done。
實務提醒:MPMoviePlayerController 與 MPMediaPickerController 都已在 iOS 9 之後被標記為不建議使用。播放本機或網路影片請改用 AVPlayer 搭配 AVPlayerViewController;若要自訂播放控制項,則需要自行處理 MPNowPlayingInfoCenter 與遠端控制事件。
它與 UIImagePickerController 的設計概念一致,讓使用者從音樂庫中挑選歌曲、Podcast 或有聲書。
建立與設定
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;
代理方法
- (void)mediaPicker:(MPMediaPickerController *)mediaPicker
didPickMediaItems:(MPMediaItemCollection *)mediaItemCollection {
/* 在這裡處理使用者挑選的結果 */
for (MPMediaItem *item in [mediaItemCollection items]) {
// 每個 item 都可查詢標題、演出者、播放網址等屬性
}
[self dismissViewControllerAnimated:YES completion:nil];
}
-(void)mediaPickerDidCancel:(MPMediaPickerController *)mediaPicker {
[self dismissViewControllerAnimated:YES completion:nil];
}
顯示
[self presentViewController:mpc animated:YES completion:nil];
關鍵點
回呼中的 mediaItemCollection.items 就是使用者選取結果的集合,每個元素都是 MPMediaItem,可查詢其各項屬性(標題、專輯、長度、資產 URL 等)。屬性眾多,實際開發時查閱 MPMediaItem 的標頭檔或官方文件最為準確。新專案請改用 MPMediaPickerRequest(iOS 10 起)或 PHPickerViewController 搭配 Photos 框架來挑選媒體。