正兒八經學iOS系列 - AVPlayer實現流音訊邊播邊存

weixin_34208283發表於2016-08-20

iOS音訊

邊播邊下有三套左右實現思路，本文使用AVPlayer + AVURLAsset實現。

概述

1. AVPlayer簡介

AVPlayer存在於AVFoundation中，可以播放視訊和音訊，可以理解為一個隨身聽
AVPlayer的關聯類：
- AVAsset：一個抽象類，不能直接使用，代表一個要播放的資源。可以理解為一個磁帶子類AVURLAsset是根據URL生成的包含媒體資訊的資源物件。我們就是要通過這個類的代理實現音訊的邊播邊下的
- AVPlayerItem：可以理解為一個裝在磁帶盒子裡的磁帶

2. AVPlayer播放原理

給播放器設定好想要它播放的URL
播放器向URL所在的伺服器傳送請求，請求兩個東西
- 所需音訊片段的起始offset
- 所需的音訊長度
伺服器根據請求的內容，返回資料
播放器拿到資料拼裝成檔案
播放器從拼裝好的檔案中，找出現在需要播放的片段，進行播放

3. 邊播邊下的原理

實現邊下邊播，其實就是手動實現AVPlayer的上列播放過程。

當播放器需要預先快取一些資料的時候，不讓播放器直接向伺服器發起請求，而是向我們自己寫的某個類（暫且稱之為播放器的祕書）發起快取請求
祕書根據播放器的快取請求的請求內容，向伺服器發起請求。
伺服器返回祕書所需的資料
祕書把伺服器返回的資料寫進本地的快取檔案中
當需要播放某段聲音的時候，向祕書發出播放請求索要這段音訊檔案
祕書從本地的快取檔案中找到播放器播放請求所需片段，返回給播放器
播放器拿到資料開心滴播放
當整首歌都快取完成以後，祕書需要把快取檔案拷貝一份，改個名字，這個檔案就是我們所需要的本地持久化檔案
下次播放器再播放歌曲的時候，先判斷下本地有木有這個名字的檔案，有則播放本地檔案，木有則向祕書要資料

技術實現

OK，邊播邊下的原理知道了，我們可以正式寫程式碼了_{建議先從文末連結處把Demo下載下來，對著Demo我們們慢慢道來}

1. 類

共需要三個類：

MusicPlayerManager：CEO。單例，負責整個工程所有的播放、暫停、下一曲、結束、判斷應該播放本地檔案還是從伺服器拉資料之類的事情
RequestLoader：就是上文所說的祕書，負責給播放器提供播放所需的音訊片段，以及找人向伺服器索要資料
RequestTask：祕書的小弟。負責和伺服器連線、向伺服器請求資料、把請求回來的資料寫到本地快取檔案、把寫完的快取檔案移到持久化目錄去。所有髒活累活都是他做。

2. 方法

先從小弟說起

2.1. RequestTask

2.1.0. 概說

如上文所說，小弟是負責做髒活累活的。負責和伺服器連線、向伺服器請求資料、把請求回來的資料寫到本地快取檔案、把寫完的快取檔案移到持久化目錄去

2.1.1. 初始化音訊檔案持久化資料夾 & 快取檔案

private func _initialTmpFile() {
        do { try NSFileManager.defaultManager().createDirectoryAtPath(StreamAudioConfig.audioDicPath, withIntermediateDirectories: true, attributes: nil) } catch { print("creat dic false -- error:\(error)") }
        if NSFileManager.defaultManager().fileExistsAtPath(StreamAudioConfig.tempPath) {
            try! NSFileManager.defaultManager().removeItemAtPath(StreamAudioConfig.tempPath)
        }
        NSFileManager.defaultManager().createFileAtPath(StreamAudioConfig.tempPath, contents: nil, attributes: nil)
    }

2.1.2. 與伺服器建立連線請求資料

/**
     連線伺服器，請求資料（或拼range請求部分資料）（此方法中會將協議頭修改為http）
     
     - parameter offset: 請求位置
     */
    public func set(URL url: NSURL, offset: Int) {
        
        func initialTmpFile() {
            try! NSFileManager.defaultManager().removeItemAtPath(StreamAudioConfig.tempPath)
            NSFileManager.defaultManager().createFileAtPath(StreamAudioConfig.tempPath, contents: nil, attributes: nil)
        }
        _updateFilePath(url)
        self.url = url
        self.offset = offset
        
        //  如果建立第二次請求，則需初始化緩衝檔案
        if taskArr.count >= 1 {
            initialTmpFile()
        }
        
        //  初始化已下載檔案長度
        downLoadingOffset = 0
        
        //  把stream://xxx的頭換成http://的頭
        let actualURLComponents = NSURLComponents(URL: url, resolvingAgainstBaseURL: false)
        actualURLComponents?.scheme = "http"
        guard let URL = actualURLComponents?.URL else {return}
        let request = NSMutableURLRequest(URL: URL, cachePolicy: NSURLRequestCachePolicy.ReloadIgnoringCacheData, timeoutInterval: 20.0)
        
        //  若非從頭下載，且視訊長度已知且大於零，則下載offset到videoLength的範圍（拼request引數）
        if offset > 0 && videoLength > 0 {
            request.addValue("bytes=\(offset)-\(videoLength - 1)", forHTTPHeaderField: "Range")
        }
        
        connection?.cancel()
        connection = NSURLConnection(request: request, delegate: self, startImmediately: false)
        connection?.setDelegateQueue(NSOperationQueue.mainQueue())
        connection?.start()
    }

2.1.3. 響應伺服器的Response頭

      public func connection(connection: NSURLConnection, didReceiveResponse response: NSURLResponse) {
        isFinishLoad = false
        guard response is NSHTTPURLResponse else {return}
        //  解析頭部資料
        let httpResponse = response as! NSHTTPURLResponse
        let dic = httpResponse.allHeaderFields
        let content = dic["Content-Range"] as? String
        let array = content?.componentsSeparatedByString("/")
        let length = array?.last
        //  拿到真實長度
        var videoLength = 0
        if Int(length ?? "0") == 0 {
            videoLength = Int(httpResponse.expectedContentLength)
        } else {
            videoLength = Int(length!)!
        }
        
        self.videoLength = videoLength
        //TODO: 此處需要修改為真實資料格式 - 從字典中取
        self.mimeType = "video/mp4"
        //  回撥
        recieveVideoInfoHandler?(task: self, videoLength: videoLength, mimeType: mimeType!)
        //  連線加入到任務陣列中
        taskArr.append(connection)
        //  初始化檔案傳輸控制程式碼
        fileHandle = NSFileHandle.init(forWritingAtPath: StreamAudioConfig.tempPath)
    }

2.1.4. 處理伺服器返回的資料 - 寫入快取檔案中

    public func connection(connection: NSURLConnection, didReceiveData data: NSData) {
        
        //  定址到檔案末尾
        self.fileHandle?.seekToEndOfFile()
        self.fileHandle?.writeData(data)
        self.downLoadingOffset += data.length
        self.receiveVideoDataHandler?(task: self)
        
//        print("執行緒 - \(NSThread.currentThread())")
        
        //  注意，這裡用子執行緒有問題
        let queue = dispatch_queue_create("com.azen.taskConnect", DISPATCH_QUEUE_SERIAL)
        dispatch_async(queue) {
//            //  定址到檔案末尾
//            self.fileHandle?.seekToEndOfFile()
//            self.fileHandle?.writeData(data)
//            self.downLoadingOffset += data.length
//            self.receiveVideoDataHandler?(task: self)
//            let thread = NSThread.currentThread()
//            print("執行緒 - \(thread)")
        }

2.1.5. 伺服器檔案返回完畢，把快取檔案放入持久化資料夾

    public func connectionDidFinishLoading(connection: NSURLConnection) {
        func tmpPersistence() {
            isFinishLoad = true
            let fileName = url?.lastPathComponent
//            let movePath = audioDicPath.stringByAppendingPathComponent(fileName ?? "undefine.mp4")
            let movePath = StreamAudioConfig.audioDicPath + "/\(fileName ?? "undefine.mp4")"
            _ = try? NSFileManager.defaultManager().removeItemAtPath(movePath)
            
            var isSuccessful = true
            do { try NSFileManager.defaultManager().copyItemAtPath(StreamAudioConfig.tempPath, toPath: movePath) } catch {
                isSuccessful = false
                print("tmp檔案持久化失敗")
            }
            if isSuccessful {
                print("持久化檔案成功！路徑 - \(movePath)")
            }
        }
        
        if taskArr.count < 2 {
            tmpPersistence()
        }
        
        receiveVideoFinishHanlder?(task: self)
    }

其他

其他方法包括斷線重連以及公開一個cancel方法cancel掉和伺服器的連線

2.2. RequestLoader

2.2.0. 概說

祕書要乾的最主要的事情就是響應播放器老大的號令，所有方法都是圍繞著播放器老大來的。祕書需要遵循AVAssetResourceLoaderDelegate協議才能被錄用。

2.2.1. 代理方法，播放器需要快取資料的時候，會調這個方法

這個方法其實是播放器在說：小祕呀，我想要這段音訊檔案。你能現在給我還是等等給我啊？
一定要返回：true，告訴播放器，我等等給你。
然後，立馬找本地快取檔案裡有木有這段資料，有把資料拿給播放器，如果木有，則派祕書的小弟向伺服器要。
具體實現程式碼有點多，這裡就不全部貼出來了。可以去看看文末的Demo記得賞顆星喲~

    /**
     播放器問：是否應該等這requestResource載入完再說？
     這裡會出現很多個loadingRequest請求， 需要為每一次請求作出處理
     
     - parameter resourceLoader: 資源管理器
     - parameter loadingRequest: 每一小塊資料的請求
     
     - returns: <#return value description#>
     */
    public func resourceLoader(resourceLoader: AVAssetResourceLoader, shouldWaitForLoadingOfRequestedResource loadingRequest: AVAssetResourceLoadingRequest) -> Bool {
        //  新增請求到佇列
        pendingRequset.append(loadingRequest)
        //  處理請求
        _dealWithLoadingRequest(loadingRequest)
        print("----\(loadingRequest)")
        return true
    }

2.2.2. 代理方法，播放器關閉了下載請求

    /**
     播放器關閉了下載請求
     播放器關閉一箇舊請求，都會發起一到多個新請求，除非已經播放完畢了
     
     - parameter resourceLoader: 資源管理器
     - parameter loadingRequest: 待關請求
     */
    public func resourceLoader(resourceLoader: AVAssetResourceLoader, didCancelLoadingRequest loadingRequest: AVAssetResourceLoadingRequest) {
        guard let index = pendingRequset.indexOf(loadingRequest) else {return}
        pendingRequset.removeAtIndex(index)
    }

2.3. MusicPlayerManager

2.3.0. 概說

負責排程所有播放器的，負責App中的一切涉及音訊播放的事件
唔。。犯個小懶。。程式碼直接貼上來咯_{要趕不上樓下的538路公交啦}_{謝謝大家體諒哦}

public class MusicPlayerManager: NSObject {
    
    
    //  public var status
    
    public var currentURL: NSURL? {
        get {
            guard let currentIndex = currentIndex, musicURLList = musicURLList where currentIndex < musicURLList.count else {return nil}
            return musicURLList[currentIndex]
        }
    }
    
    /**播放狀態，用於需要獲取播放器狀態的地方KVO*/
    public var status: ManagerStatus = .Non
    /**播放進度*/
    public var progress: CGFloat {
        get {
            if playDuration > 0 {
                let progress = playTime / playDuration
                return progress
            } else {
                return 0
            }
        }
    }
    /**已播放時長*/
    public var playTime: CGFloat = 0
    /**總時長*/
    public var playDuration: CGFloat = CGFloat.max
    /**緩衝時長*/
    public var tmpTime: CGFloat = 0
    
    public var playEndConsul: (()->())?
    /**強引用控制器，防止被銷燬*/
    public var currentController: UIViewController?
    
    //  private status
    private var currentIndex: Int?
    private var currentItem: AVPlayerItem? {
        get {
            if let currentURL = currentURL {
                let item = getPlayerItem(withURL: currentURL)
                return item
            } else {
                return nil
            }
        }
    }
    
    private var musicURLList: [NSURL]?
    
    //  basic element
    public var player: AVPlayer?
    
    private var playerStatusObserver: NSObject?
    private var resourceLoader: RequestLoader = RequestLoader()
    private var currentAsset: AVURLAsset?
    private var progressCallBack: ((tmpProgress: Float?, playProgress: Float?)->())?
    
    public class var sharedInstance: MusicPlayerManager {
        struct Singleton {
            static let instance = MusicPlayerManager()
        }
        //  後臺播放
        let session = AVAudioSession.sharedInstance()
        do { try session.setActive(true) } catch { print(error) }
        do { try session.setCategory(AVAudioSessionCategoryPlayback) } catch { print(error) }
        return Singleton.instance
    }
    
    public enum ManagerStatus {
        case Non, LoadSongInfo, ReadyToPlay, Play, Pause, Stop
    }
}

// MARK: - basic public funcs
extension MusicPlayerManager {
    /**
     開始播放
     */
    public func play(musicURL: NSURL?) {
        guard let musicURL = musicURL else {return}
        if let index = getIndexOfMusic(music: musicURL) {   //   歌曲在佇列中，則按順序播放
            currentIndex = index
        } else {
            putMusicToArray(music: musicURL)
            currentIndex = 0
        }
        playMusicWithCurrentIndex()
    }
    
    public func play(musicURL: NSURL?, callBack: ((tmpProgress: Float?, playProgress: Float?)->())?) {
        play(musicURL)
        progressCallBack = callBack
    }
    
    public func next() {
        currentIndex = getNextIndex()
        playMusicWithCurrentIndex()
    }
    
    public func previous() {
        currentIndex = getPreviousIndex()
        playMusicWithCurrentIndex()
    }
    /**
     繼續
     */
    public func goOn() {
        player?.rate = 1
    }
    /**
     暫停 - 可繼續
     */
    public func pause() {
        player?.rate = 0
    }
    /**
     停止 - 無法繼續
     */
    public func stop() {
        endPlay()
    }
}

// MARK: - private funcs
extension MusicPlayerManager {
    
    private func putMusicToArray(music URL: NSURL) {
        if musicURLList == nil {
            musicURLList = [URL]
        } else {
            musicURLList!.insert(URL, atIndex: 0)
        }
    }
    
    private func getIndexOfMusic(music URL: NSURL) -> Int? {
        let index = musicURLList?.indexOf(URL)
        return index
    }
    
    private func getNextIndex() -> Int? {
        if let musicURLList = musicURLList where musicURLList.count > 0 {
            if let currentIndex = currentIndex where currentIndex + 1 < musicURLList.count {
                return currentIndex + 1
            } else {
                return 0
            }
        } else {
            return nil
        }
    }
    
    private func getPreviousIndex() -> Int? {
        if let currentIndex = currentIndex {
            if currentIndex - 1 >= 0 {
                return currentIndex - 1
            } else {
                return musicURLList?.count ?? 1 - 1
            }
        } else {
            return nil
        }
    }
    
    /**
     從頭播放音樂列表
     */
    private func replayMusicList() {
        guard let musicURLList = musicURLList where musicURLList.count > 0 else {return}
        currentIndex = 0
        playMusicWithCurrentIndex()
    }
    /**
     播放當前音樂
     */
    private func playMusicWithCurrentIndex() {
        guard let currentURL = currentURL else {return}
        //  結束上一首
        endPlay()
        player = AVPlayer(playerItem: getPlayerItem(withURL: currentURL))
        observePlayingItem()
    }
    /**
     本地不存在，返回nil，否則返回本地URL
     */
    private func getLocationFilePath(url: NSURL) -> NSURL? {
        let fileName = url.lastPathComponent
        let path = StreamAudioConfig.audioDicPath + "/\(fileName ?? "tmp.mp4")"
        if NSFileManager.defaultManager().fileExistsAtPath(path) {
            let url = NSURL.init(fileURLWithPath: path)
            return url
        } else {
            return nil
        }
    }
    
    private func getPlayerItem(withURL musicURL: NSURL) -> AVPlayerItem {
        
        if let locationFile = getLocationFilePath(musicURL) {
            let item = AVPlayerItem(URL: locationFile)
            return item
        } else {
            let playURL = resourceLoader.getURL(url: musicURL)!  //  轉換協議頭
            let asset = AVURLAsset(URL: playURL)
            currentAsset = asset
            asset.resourceLoader.setDelegate(resourceLoader, queue: dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0))
            let item = AVPlayerItem(asset: asset)
            return item
        }
    }
    
    private func setupPlayer(withURL musicURL: NSURL) {
        let songItem = getPlayerItem(withURL: musicURL)
        player = AVPlayer(playerItem: songItem)
    }
    
    private func playerPlay() {
        player?.play()
    }
    
    private func endPlay() {
        status = ManagerStatus.Stop
        player?.rate = 0
        removeObserForPlayingItem()
        player?.replaceCurrentItemWithPlayerItem(nil)
        resourceLoader.cancel()
        currentAsset?.resourceLoader.setDelegate(nil, queue: nil)
        
        progressCallBack = nil
        resourceLoader = RequestLoader()
        playDuration = 0
        playTime = 0
        playEndConsul?()
        player = nil
    }
}

extension MusicPlayerManager {
    public override func observeValueForKeyPath(keyPath: String?, ofObject object: AnyObject?, change: [String : AnyObject]?, context: UnsafeMutablePointer<Void>) {
        guard object is AVPlayerItem else {return}
        let item = object as! AVPlayerItem
        if keyPath == "status" {
            if item.status == AVPlayerItemStatus.ReadyToPlay {
                status = .ReadyToPlay
                print("ReadyToPlay")
                let duration = item.duration
                playerPlay()
                print(duration)
            } else if item.status == AVPlayerItemStatus.Failed {
                status = .Stop
                print("Failed")
                stop()
            }
        } else if keyPath == "loadedTimeRanges" {
            let array = item.loadedTimeRanges
            guard let timeRange = array.first?.CMTimeRangeValue else {return}  //  緩衝時間範圍
            let totalBuffer = CMTimeGetSeconds(timeRange.start) + CMTimeGetSeconds(timeRange.duration)    //  當前緩衝長度
            tmpTime = CGFloat(tmpTime)
            print("共緩衝 - \(totalBuffer)")
            let tmpProgress = tmpTime / playDuration
            progressCallBack?(tmpProgress: Float(tmpProgress), playProgress: nil)
        }
    }
    
    private func observePlayingItem() {
        guard let currentItem = self.player?.currentItem else {return}
        //  KVO監聽正在播放的物件狀態變化
        currentItem.addObserver(self, forKeyPath: "status", options: NSKeyValueObservingOptions.New, context: nil)
        //  監聽player播放情況
        playerStatusObserver = player?.addPeriodicTimeObserverForInterval(CMTimeMake(1, 1), queue: dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), usingBlock: { [weak self] (time) in
            guard let `self` = self else {return}
            //  獲取當前播放時間
            self.status = .Play
            let currentTime = CMTimeGetSeconds(time)
            let totalTime = CMTimeGetSeconds(currentItem.duration)
            self.playDuration = CGFloat(totalTime)
            self.playTime = CGFloat(currentTime)
            print("current time ---- \(currentTime) ---- tutalTime ---- \(totalTime)")
            self.progressCallBack?(tmpProgress: nil, playProgress: Float(self.progress))
            if totalTime - currentTime < 0.1 {
                self.endPlay()
            }
            }) as? NSObject
        //  監聽快取情況
        currentItem.addObserver(self, forKeyPath: "loadedTimeRanges", options: NSKeyValueObservingOptions.New, context: nil)
    }
    
    private func removeObserForPlayingItem() {
        guard let currentItem = self.player?.currentItem else {return}
        currentItem.removeObserver(self, forKeyPath: "status")
        if playerStatusObserver != nil {
            player?.removeTimeObserver(playerStatusObserver!)
            playerStatusObserver = nil
        }
        currentItem.removeObserver(self, forKeyPath: "loadedTimeRanges")
    }
}

public struct StreamAudioConfig {
    static let audioDicPath: String = NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory.DocumentDirectory, NSSearchPathDomainMask.UserDomainMask, true).last! + "/streamAudio"  //  緩衝資料夾
    static let tempPath: String = audioDicPath + "/temp.mp4"    //  緩衝檔案路徑 - 非持久化檔案路徑 - 當前邏輯下，有且只有一個緩衝檔案
    
}

iOS音訊邊播邊下Demo，戳這裡~

如果對大家有點小幫助，記得賞顆Star哦~ 謝啦~?

iOS邊下邊播總結
2021-12-10
iOS
iOS視訊邊下邊播–快取播放資料流
2016-03-03
iOS快取
IOS音視訊（四十五）HTTPS 自簽名證書實現邊下邊播
2020-04-05
iOSHTTP
iOS 邊學邊記
2020-11-20
iOS
iOS端音訊邊錄邊轉和聲波圖的實現
2017-12-21
iOS音訊
邊下載邊播放的播放器Android邊下邊播
2018-07-17
播放器Android
【Python | 邊敲邊學邊記】第一次：正規表示式
2018-10-12
Python
Go 邊看邊練 - 《Go 學習筆記》系列
2016-10-23
Go筆記
Android 實現視屏播放器、邊播邊快取功能、外加鏟屎（IJKPlayer）
2016-11-18
Android播放器快取
聽技術播客：一邊學Python程式設計一邊學英語
2016-01-17
Python程式設計
[正兒八經PHP]PHP閉包（Closure）初探
2016-06-14
PHP
[轉]Go 邊看邊練 -《Go 學習筆記》系列（一）
2016-10-22
Go筆記
css實現圖片背景填充的正六邊形
2019-02-27
CSS
Android 實現邊聽伴奏邊K歌探究
2018-03-18
Android
機器學習實戰-邊學邊讀python程式碼(5)
2015-12-15
機器學習Python
機器學習實戰-邊學邊讀python程式碼(4)
2015-11-26
機器學習Python
Flutter實現一個邊讀邊處理邊傳送檔案的功能
2021-09-02
Flutter
Java實現多檔案邊壓縮邊下載
2018-06-13
Java
邊學邊玩CSS Grid
2018-08-12
CSS
帶你用AVPlayer實現音訊和視訊播放
2021-10-28
音訊
【從0到1學習邊緣容器系列1】之邊緣計算與邊緣容器的起源
2020-10-15
Akka邊學邊寫（2）-- Echo Server
2014-10-13
Server
【從0到1學習邊緣容器系列2】之邊緣應用管理
2020-10-15
小視訊原始碼，CSS 實現半透明邊框效果
2022-06-14
原始碼CSS
CSS實現流動邊框
2020-10-11
CSS
第11周-八邊形Octagon類
2015-11-15
Go
to banq : 請教如何邊學習邊實踐的方法論問題
2008-05-25
[邊學邊練]用簡單例項學習React
2018-08-27
單例React
六邊形架構 Java 實現
2019-04-02
架構Java
css實現的交叉邊框效果
2017-03-07
CSS
css實現邊框陰影效果
2017-02-11
CSS
javascript實現動態側邊欄
2014-02-18
JavaScript
【從0到1學習邊緣容器系列-3】應用容災之邊緣自治
2020-10-15
vue專案中使用swiper實現中間大，兩邊小的輪播圖
2019-11-22
Vue
iOS AVPlayer之後臺連續播放視訊
2017-12-25
iOS
iOS AVPlayer播放視訊的留白處理
2017-12-20
iOS
風變程式設計邊學習邊實操，讓過程更快樂！
2023-01-09
程式設計
學習OpenCV：濾鏡系列（15）——羽化（模糊邊緣）
2014-11-25
OpenCV