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

iOS 音頻篇:用 AVPlayer 播放網絡音樂的完整實踐

編輯:iOS 開發基礎

作者:明仔Su(簡書)

引言

假如現在要動手做一個類似百度音樂、豆瓣電台的線上音樂 App,你會怎麼做?

先了解音頻播放的四個實作層級:

  1. 離線播放:這裡不是指 App 不聯網,而是指播放本地音檔(包含先下載完成再播放的情況),用 AVFoundation 裡的 AVAudioPlayer 就能滿足;

  2. 線上播放:使用 AVFoundation 的 AVPlayer 即可;

  3. 線上播放同時存檔:AudioFileStreamer + AudioQueue;

  4. 線上播放且需要音效處理:AudioFileStreamer + AudioQueue + 音效模組(系統自帶或自行開發)。

本文針對第二種層級,介紹如何用 AVPlayer 實現網絡音樂的播放。

什麼是 AVPlayer

AVPlayer 位於 AVFoundation 中,它本質上是一個視頻播放器,但拿來放音樂完全沒問題。播放音樂不需要呈現畫面,因此我們也不必實作它的界面。

與 AVPlayer 關係密切的兩個名詞:

  • AVAsset:抽象類,不能直接使用;其子類 AVURLAsset 可依 URL 生成包含媒體資訊的 Asset 物件。

  • AVPlayerItem:與媒體資源一一對應,負責管理媒體資源的資訊與狀態。

功能需求

一個音樂播放器呈現在界面上,通常需要實作:

  1. (核心)透過網絡鏈接播放音樂

  2. (基本)常用操作:暫停、播放、上一首、下一首等

  3. (基本)監聽播放進度、取得總時長與當前播放時間

  4. (基本)監聽播放器狀態:媒體加載狀態、數據緩衝狀態、播放完畢狀態

  5. (可選)Remote Control 控制播放

  6. (可選)Now Playing Center 展示正在播放的歌曲

功能實作

1. 透過網絡鏈接播放音樂

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;

2. 播放器的常用操作

播放:

[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];

3. 監聽播放進度

使用 addPeriodicTimeObserverForInterval:queue:usingBlock: 監聽進度,有幾點要留意:

  1. 傳入一個 CMTime 結構,每隔一段時間回調一次,包含開始與結束播放;

  2. 若 block 內操作耗時過長,下一次不一定收到回調,所以要盡量精簡 block 內容;

  3. 該方法會回傳一個觀察者物件,播放完畢時必須移除。

添加觀察者:

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;
}

4. 監聽播放器狀態

(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];

5. Remote Control 控制音樂播放

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;
    }
}

6. Now Playing Center

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」,有興趣可以研究一下。

整體播放邏輯

總結一下音樂播放器的播放流程:

  1. 初始化播放界面

  2. 從介面取得播放列表,選第一首作為當前歌曲

  3. 依當前歌曲初始化播放器;同步歌曲資訊到播放界面(此時應展示歌曲資訊,但播放按鈕不可用,並顯示 loading 提示);同步資訊到 Now Playing Center

  4. 當 status 變為 ReadyToPlay 時開始播放,同步播放資訊(時間、總時長、進度條等)到播放界面與 Now Playing Center

  5. 使用者暫停時,刷新播放界面

  1. 使用者執行上一首/下一首,或某首歌播放完成時,把對應歌曲設為當前歌曲,重複第 3 至 5 步

  2. 網絡不佳導致播放器自動暫停時,刷新播放界面

  3. 網絡不佳導致播放器進不去播放狀態時,要有所處理(例如提示耐心等待,或改播本地離線歌曲)

後記

本文僅從實作基本功能的角度介紹了 AVPlayer 播放網絡音樂的做法。事實上 AVPlayer 的能力遠不止於此,有興趣的同學可以深入研究 AVFoundation。

如需類似豆瓣電台 App 的專案 Demo,可以到明仔Su 的 GitHub 下載學習。

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