
作者:明仔Su(簡書)
假如現在要動手做一個類似百度音樂、豆瓣電台的線上音樂 App,你會怎麼做?
先了解音頻播放的四個實作層級:
離線播放:這裡不是指 App 不聯網,而是指播放本地音檔(包含先下載完成再播放的情況),用 AVFoundation 裡的 AVAudioPlayer 就能滿足;
線上播放:使用 AVFoundation 的 AVPlayer 即可;
線上播放同時存檔:AudioFileStreamer + AudioQueue;
線上播放且需要音效處理:AudioFileStreamer + AudioQueue + 音效模組(系統自帶或自行開發)。
本文針對第二種層級,介紹如何用 AVPlayer 實現網絡音樂的播放。
AVPlayer 位於 AVFoundation 中,它本質上是一個視頻播放器,但拿來放音樂完全沒問題。播放音樂不需要呈現畫面,因此我們也不必實作它的界面。
與 AVPlayer 關係密切的兩個名詞:
AVAsset:抽象類,不能直接使用;其子類 AVURLAsset 可依 URL 生成包含媒體資訊的 Asset 物件。
AVPlayerItem:與媒體資源一一對應,負責管理媒體資源的資訊與狀態。
一個音樂播放器呈現在界面上,通常需要實作:
(核心)透過網絡鏈接播放音樂
(基本)常用操作:暫停、播放、上一首、下一首等
(基本)監聽播放進度、取得總時長與當前播放時間
(基本)監聽播放器狀態:媒體加載狀態、數據緩衝狀態、播放完畢狀態
(可選)Remote Control 控制播放
(可選)Now Playing Center 展示正在播放的歌曲
NSURL *url = [NSURL URLWithString:self.currentSong.url]; AVPlayerItem *songItem = [[AVPlayerItem alloc] initWithURL:url]; AVPlayer *player = [[AVPlayer alloc] initWithPlayerItem:songItem];
也可以直接用 URL 初始化 player:
AVPlayer *player = [[AVPlayer alloc] initWithURL:url];
取得當前播放的 item:
AVPlayerItem *songItem = player.currentItem;
播放:
[player play];
注意:初始化完成後不一定立刻開始播放,需要等 player 的狀態變為 ReadyToPlay。
暫停:
[player pause];
上一首/下一首有兩種做法。一是自行控制下一首歌的 item,替換當前播放項:
[player replaceCurrentItemWithPlayerItem:songItem];
二是使用 AVPlayer 的子類 AVQueuePlayer 一次載入多個 item,呼叫 advanceToNextItem 切歌:
NSArray *items = @[item1, item2, item3 ...]; AVQueuePlayer *queuePlayer = [[AVQueuePlayer alloc] initWithItems:items];
使用 addPeriodicTimeObserverForInterval:queue:usingBlock: 監聽進度,有幾點要留意:
傳入一個 CMTime 結構,每隔一段時間回調一次,包含開始與結束播放;
若 block 內操作耗時過長,下一次不一定收到回調,所以要盡量精簡 block 內容;
該方法會回傳一個觀察者物件,播放完畢時必須移除。
添加觀察者:
id timeObserve = [self.player addPeriodicTimeObserverForInterval:CMTimeMake(1.0, 1.0) queue:dispatch_get_main_queue() usingBlock:^(CMTime time) {
float current = CMTimeGetSeconds(time);
float total = CMTimeGetSeconds(songItem.duration);
if (current) {
weakSelf.progress = current / total;
weakSelf.playTime = [NSString stringWithFormat:@"%.f", current];
weakSelf.playDuration = [NSString stringWithFormat:@"%.2f", total];
}
}];移除觀察者:
if (timeObserve) {
[player removeTimeObserver:_timeObserve];
timeObserve = nil;
}(1)媒體加載狀態
[songItem addObserver:self forKeyPath:@"status" options:NSKeyValueObservingOptionNew context:nil];
在 KVO 回調中取得狀態變化:
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context {
if ([keyPath isEqualToString:@"status"]) {
switch (self.player.status) {
case AVPlayerStatusUnknown:
BASE_INFO_FUN(@"KVO:未知狀態,此時不能播放");
break;
case AVPlayerStatusReadyToPlay:
self.status = SUPlayStatusReadyToPlay;
BASE_INFO_FUN(@"KVO:準備完畢,可以播放");
break;
case AVPlayerStatusFailed:
BASE_INFO_FUN(@"KVO:加載失敗,網絡或者服務器出現問題");
break;
default:
break;
}
}
}一般從初始化 player 到能播放,都會經歷 Unknown → ReadyToPlay 這個過程。網絡良好時可能幾乎看不到 Unknown 提示;網絡差時 Unknown 可能持續很久,甚至一直進不到 ReadyToPlay,這種情況需要額外處理。
播放完成後記得移除觀察者:
[songItem removeObserver:self forKeyPath:@"status"];
(2)數據緩衝狀態
[songItem addObserver:self forKeyPath:@"loadedTimeRanges" options:NSKeyValueObservingOptionNew context:nil];
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context {
AVPlayerItem *songItem = object;
if ([keyPath isEqualToString:@"loadedTimeRanges"]) {
NSArray *array = songItem.loadedTimeRanges;
CMTimeRange timeRange = [array.firstObject CMTimeRangeValue]; // 本次緩衝的時間範圍
NSTimeInterval totalBuffer = CMTimeGetSeconds(timeRange.start) + CMTimeGetSeconds(timeRange.duration); // 緩衝總長度
SuLog(@"共緩沖 %.2f", totalBuffer);
}
}如果需要在進度條上展示緩衝進度,就加上這個觀察者。播放完成後同樣要移除:
[songItem removeObserver:self forKeyPath:@"loadedTimeRanges"];
(3)播放完畢狀態:監聽 AVPlayer 的完成通知
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(playbackFinished:) name:AVPlayerItemDidPlayToEndTimeNotification object:songItem];
- (void)playbackFinished:(NSNotification *)notice {
BASE_INFO_FUN(@"播放完成");
[self playNext];
}播放完畢後一般都會接著播放下一首。切下一首前,別忘了移除這個 item 的通知觀察:
[[NSNotificationCenter defaultCenter] removeObserver:self];
Remote Control 讓使用者不必打開 App 就能控制播放,最常見的三個場景是鎖屏介面、從螢幕底部上拉的控制中心,以及耳機線控,能顯著提升使用體驗。
我們在 AppDelegate 中設定:
(1)宣告接收 Remote Control 事件
[[UIApplication sharedApplication] beginReceivingRemoteControlEvents];
(2)重寫方法,成為第一響應者
- (BOOL)canBecomeFirstResponder {
return YES;
}(3)處理事件
- (void)remoteControlReceivedWithEvent:(UIEvent *)event {
switch (event.subtype) {
case UIEventSubtypeRemoteControlPlay:
[self.player startPlay];
BASE_INFO_FUN(@"remote_播放");
break;
case UIEventSubtypeRemoteControlPause:
[self.player pausePlay];
BASE_INFO_FUN(@"remote_暫停");
break;
case UIEventSubtypeRemoteControlNextTrack:
[self.player playNextSong];
BASE_INFO_FUN(@"remote_下一首");
break;
case UIEventSubtypeRemoteControlTogglePlayPause:
self.player.isPlaying ? [self.player pausePlay] : [self.player startPlay];
BASE_INFO_FUN(@"remote_耳機的播放/暫停");
break;
default:
break;
}
}Now Playing Center 能在鎖屏介面展示歌曲資訊,同樣屬於提升體驗的環節。
- (void)configNowPlayingCenter {
BASE_INFO_FUN(@"配置 NowPlayingCenter");
NSMutableDictionary *info = [NSMutableDictionary dictionary];
// 音樂的標題
[info setObject:_player.currentSong.title forKey:MPMediaItemPropertyTitle];
// 音樂的藝術家
[info setObject:_player.currentSong.artist forKey:MPMediaItemPropertyArtist];
// 音樂的播放時間
[info setObject:@(self.player.playTime.intValue) forKey:MPNowPlayingInfoPropertyElapsedPlaybackTime];
// 音樂的播放速度
[info setObject:@(1) forKey:MPNowPlayingInfoPropertyPlaybackRate];
// 音樂的總時間
[info setObject:@(self.player.playDuration.intValue) forKey:MPMediaItemPropertyPlaybackDuration];
// 音樂的封面
MPMediaItemArtwork *artwork = [[MPMediaItemArtwork alloc] initWithImage:_player.coverImg];
[info setObject:artwork forKey:MPMediaItemPropertyArtwork];
// 完成設置
[[MPNowPlayingInfoCenter defaultCenter] setNowPlayingInfo:info];
}Now Playing Center 並不需要每秒刷新,它會依你設定的 PlaybackRate 自行推算進度條的推進——傳 1 就是一秒走一格;暫停時它也會自動跟著暫停。
那什麼時候設定它比較合適?對網絡音樂而言,需要刷新的時間點有幾個:當前歌曲變化時(例如切到下一首)、歌曲資訊變化時(例如從 Unknown 到 ReadyToPlay)、使用者拖動進度時。
如果你用百度音樂聽歌,應該會注意到它帶有鎖屏歌詞。其原理其實是「把歌詞與封面合成新圖片作為 Now Playing Center 的封面,並在歌詞跳動時刷新 Now Playing Center」,有興趣可以研究一下。
總結一下音樂播放器的播放流程:
初始化播放界面
從介面取得播放列表,選第一首作為當前歌曲
依當前歌曲初始化播放器;同步歌曲資訊到播放界面(此時應展示歌曲資訊,但播放按鈕不可用,並顯示 loading 提示);同步資訊到 Now Playing Center
當 status 變為 ReadyToPlay 時開始播放,同步播放資訊(時間、總時長、進度條等)到播放界面與 Now Playing Center
使用者暫停時,刷新播放界面
使用者執行上一首/下一首,或某首歌播放完成時,把對應歌曲設為當前歌曲,重複第 3 至 5 步
網絡不佳導致播放器自動暫停時,刷新播放界面
網絡不佳導致播放器進不去播放狀態時,要有所處理(例如提示耐心等待,或改播本地離線歌曲)
本文僅從實作基本功能的角度介紹了 AVPlayer 播放網絡音樂的做法。事實上 AVPlayer 的能力遠不止於此,有興趣的同學可以深入研究 AVFoundation。
如需類似豆瓣電台 App 的專案 Demo,可以到明仔Su 的 GitHub 下載學習。