NicooM3u8Downloader

示例

要运行示例项目，先克隆仓库，然后在 Example 目录中运行 pod install。

要求

最近在做视频播放器，发现目前主流的视频播放都是流媒体，以前的 MP4 大文件播放时代已经过去了。之前做的一个播放器：

https://github.com/yangxina/NicooPlayer

在此之前没有支持 m3u8 流媒体播放，现在也已经兼容了 m3u8 流媒体播放。不过当前正在处理流媒体的断点续传。边下边播。

首先，边下边播的好处就不多说了，比起从服务器直接拉取数据流播放，显得更加流畅，用户体验更加爽。要做边下边播，那肯定要先玩会流媒体下载。 NicooM3u8Downloader 这个组件就是针对流媒体下载封装的一个组件。
封装思路

(1) 在线解析 m3u8 文件内容，将里面的 ts 对应连接的资源下载到本地的 Document 文件夹下。

(2) 将下载下来的资源使用本地路径重新拼接成一个新的本地 m3u8 文件。

(3) 然后在开启一个本地 http 服务端，将 m3u8 共享成连接地址，让播放器播放。

(1).m3u8 的解析：

在去做 m3u8 文件在线解析之前，必须要对 m3u8 文件格式，文件规则，文本键值对作用，意义有一定的了解。这里就不对 m3u8 做过多解释，需要了解的同学请查看博客： https://blog.csdn.net/blueboyhi/article/details/40107683 本人在做这一块时，也是先去研读了这篇博客。给博客作者点个
👍。另外还要了解一下 .ts 后缀的视频片段文件，.ts 文件就是你播放的视频文件，不过每一个 ts视频文件的长度都很短，一般就只有几秒钟，长点的也就几十秒。这里不做多解释，可以自行去查资料。
了解完了 m3u8 之后，就知道，m3u8 有可能是一层，或者两层。（不会再多，游戏规则说的是最多包一层，也就是最多两层）。

m3u8 一层：

如果 m3u8 已有一层，那么第一次解析出来就会带有 xxx.ts 流路径的 m3u8 文件内容。例如我们将一个视频 url：如（http://xxx/yyy/zzz/sss.m3u8）

解析处理的文件内容。如下：
```
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-ALLOW-CACHE:YES
#EXT-X-TARGETDURATION:21
#EXTINF:19.263833,
d104cd51ca787c02b4ceaf084801ace4_free_0000.ts
#EXTINF:8.000000,
d104cd51ca787c02b4ceaf084801ace4_free_0001.ts
#EXTINF:3.260867,
d104cd51ca787c02b4ceaf084801ace4_free_0002.ts
#EXTINF:20.043478,
d104cd51ca787c02b4ceaf084801ace4_free_0003.ts
#EXTINF:2.782611,
d104cd51ca787c02b4ceaf084801ace4_free_0004.ts
....(- 中间省略95行 - )
#EXTINF:10.869567,
d104cd51ca787c02b4ceaf084801ace4_free_0100.ts
#EXT-X-ENDLIST
```
可以看到，这里解析出来的 xxx.ts : d104cd51ca787c02b4ceaf084801ace4_free_0002.ts, 不是一个可以直接下载的全路径。这时候，需要将这个 ts 下载下来，就需要拼接一个正确的下载地址。这时候就需要对拿来解析的视频 url 进行路径切片。比如： http://xxx/yyy/zzz/sss.m3u8 这个 url。我们需要把它切成：

[ http://xxx, http://xxx/yyy, http://xxx/yyy/zzz ]

这样 3 个路径，然后将我们解析出来的 xxx.ts,分别拼接到 3 个路径后，生成 3 个 ts 文件下载路径。(其中只有一个是有效的 url)，我们需要从这 3 个（有可能是 N 个）中找到那个可以下载 ts 的有效 url。在组件内，我是直接每一个都拼接文件中第一个 ts,然后分别拿去做一次下载，下载到的第一个 ts 数据不为空，就表示当前这个 url 是有效的。当我们拿到了有效的 ts 下载路径，我们只需要创建下载任务去下载这些 ts 文件，存放到本地一个文件夹内。

m3u8 两层：

两层的 m3u8 解析，其实也就是在一层的基础上，多做一次解析，当然我们要判断第一次解析没有解析出来 ts 列表，才会做第二层解析。这里拿个例子来说：比如我们要解析： http://youku.com-www-163.com/20180506/576_bf997390/index.m3u8 这个视频地址。第一次解析出来内容如下：

"#EXTM3U\n#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=800000,RESOLUTION=1080x608\n1000k/hls/index.m3u8"

什么？？解析出来没有 ts 路径，莫慌。虽然没看到 .ts 文件路径，但是我们看到 ""#EXT-X-STREAM-INF:" " 这个，看到这玩意儿，表示我们还需要在解析一次。
那么，问题又来了：

第二次解析，我们解析哪个 url?

第一次解析出来的内容里面没有啊！！！

不，是有的。

我们看到最后有个： RESOLUTION=1080x608\n1000k/hls/index.m3u8 ，我们需要把这个带 .m3u8 后缀的东西，以 "\n" (换行符) 切开。
拿到带有 .m3u8 后缀的一段。也就是： 1000k/hls/index.m3u8

但是，我们拿到的只是后缀，前面的路径是什么？

我也不知道！

那怎么办？

一个一个试呗！（当然这里的试不是手动试，是写程序一个一个去请求试。）

这里我们就会用到一层解析，拼接有效ts路径的思路。这里我们需要，将 http://youku.com-www-163.com/20180506/576_bf997390/index.m3u8 视频url切片成：

[ http://youku.com-www-163.com, http://youku.com-www-163.com/20180506, http://youku.com-www-163.com/20180506/576_bf997390 ]

这样的一个数组，然后拼接 1000k/hls/index.m3u8 到他们后面，得到

[ http://youku.com-www-163.com/1000k/hls/index.m3u8, http://youku.com-www-163.com/20180506/1000k/hls/index.m3u8, http://youku.com-www-163.com/20180506/576_bf997390/1000k/hls/index.m3u8 ]

三个内层url,当然这里面也只有一个试正确的，能够解析到.ts列表的。这样我们只需要依次去解析每一个。如果谁能解析出来，谁就是真的。这里判断是否解析出来.ts列表，可以验证解析出来的内容是否有包含 “#EXTINF:” 或者是否包含 ”.ts“, 个人建议用第一个来判断。解析到了.ts路径列表，那么，我们就可以直接创建任务去下载了。

别急，没那个简单。

上面说的只是没有加密的.m3u8解析。一般情况下，我们会在里面加一些骚操作的。（加密）一般我们会在m3u8文件中植入加密，常用的 AES-128,对称加密。这种最常见。别的还没碰到。碰到了在更新组件。一般加密的m3u8解析出来长这样：
```
#EXTM3U\n#EXT-X-VERSION:3\n#EXT-X-TARGETDURATION:11\n#EXT-X-MEDIA-SEQUENCE:0\n#EXT-X-KEY:METHOD=AES-128,URI=\"http://xinyuan.zeikcdn.com/20180616/LQfzeEFU/800kb/hls/key.key\"\n#EXTINF:6.839,\nhttp://xinyuan.zeikcdn.com/20180616/LQfzeEFU/800kb/hls/PJy4h6573000.jpg\n#EXTINF:8.59,\nhttp://xinyuan.zeikcdn.com/20180616/LQfzeEFU/800kb/hls/PJy4h6573001.jpg\n#EXTINF:6.547,\nhttp://xinyuan.zeikcdn.com/20180616/LQfzeEFU/800kb/hls/PJy4h6573002.jpg\n
```
我们看到里面有这样一段： #EXT-X-KEY:METHOD=AES-128,URI="http://xinyuan.zeikcdn.com/20180616/LQfzeEFU/800kb/hls/key.key%5C" 我们可以看出使用了 AES-128 对称加密。既然加了密，我们怎么办？别急，m3u8 想播放器能播放，肯定会有对应的操作的；我们这里看到一个 ”URI=“ 后面是一个 http://xxx/yyy/sss.key 的路径，很奇怪。这让我们联想到密钥。对。没错。就是它。这个路径就是密钥的下载地址。我们需要将它下载下来存放到本地。记录下来它的本地路径。最好和下载的 .ts文件在一个目录。
本地m3u8文件创建

1.本地m3u8文件创建。创建本地文件：

这里不好文字描述，就上代码。反正记住两个东西： 1. 解析下载的密钥文件的相对路径，一定要写入文件， 2. 有IV的要将IV也拼接到后面。

代码如下：

这样就只需要等异步下载的ts下载完成了。

解析完了，拿到了ts的下载路径，那么ts流视频的下载也就简单了，开一堆下载任务，异步去执行ts文件的下载。这里就不做讲解了。就是下载到一个本地文件夹里面。下面我要讲的是：
(2)本地m3u8文件创建

1.本地m3u8文件创建。 2.本地服务器的搭建。

1.本地m3u8文件创建。创建本地文件：

 /// 创建本地M3u8文件，播放要用
  func createLocalM3U8file() {
      NicooDownLoadHelper.checkOrCreatedM3u8Directory(tsPlaylist.identifier)
    let filePath =           NicooDownLoadHelper.getDocumentsDirectory().appendingPathComponent(NicooDownLoadHelper.downloadFile).appendingPathComponent(tsPlaylist.identifier).appendingPathComponent("\(tsPlaylist.identifier).m3u8")
    
    /// 解密的key 所在的路径和ts视频片段在同一文件目录下，所以这里直接用相对路径，如果不在一个文件夹下，需要拼接绝对路径
    let keyPath = "key"
    ///绝对路径
    let keyPathAll = NicooDownLoadHelper.getDocumentsDirectory().appendingPathComponent(NicooDownLoadHelper.downloadFile).appendingPathComponent(tsPlaylist.identifier).appendingPathComponent("key")
    var header = "#EXTM3U\n#EXT-X-VERSION:3\n#EXT-X-TARGETDURATION:60\n"
    if m3u8Data.contains("#EXT-X-KEY:") && FileManager.default.fileExists(atPath: keyPathAll.path) {
        var keyStringPath = String(format: "#EXT-X-KEY:METHOD=AES-128,URI=\"%@\"", keyPath)
        if getIV() != nil {
            keyStringPath = String(format: "#EXT-X-KEY:METHOD=AES-128,URI=\"%@\",IV=%@", keyPath,getIV()!)
        }
        header = String(format: "#EXTM3U\n#EXT-X-VERSION:3\n#EXT-X-TARGETDURATION:60\n%@\n", keyStringPath)
    }
    var content = ""
    for i in 0 ..< tsPlaylist.tsModelArray.count {
        let segmentModel = tsPlaylist.tsModelArray[i]
        let length = "#EXTINF:\(segmentModel.duration),\n"
        let fileName = "\(segmentModel.index).ts\n"
        content += (length + fileName)
    }
    header.append(content)
    header.append("#EXT-X-ENDLIST\n")
    
    let writeData: Data = header.data(using: .utf8)!
    try! writeData.write(to: filePath)
}

这里不好文字描述，就上代码。反正记住两个东西： 1. 解析下载的密钥文件的相对路径，一定要写入文件， 2. 有IV的要将IV也拼接到后面。

代码如下：

 /// 解密的key 所在的路径和ts视频片段在同一文件目录下，所以这里直接用相对路径，如果不在一个文件夹下，需要拼接绝对路径
    let keyPath = "key"
    ///绝对路径
    let keyPathAll = NicooDownLoadHelper.getDocumentsDirectory().appendingPathComponent(NicooDownLoadHelper.downloadFile).appendingPathComponent(tsPlaylist.identifier).appendingPathComponent("key")
    var header = "#EXTM3U\n#EXT-X-VERSION:3\n#EXT-X-TARGETDURATION:60\n"
    if m3u8Data.contains("#EXT-X-KEY:") && FileManager.default.fileExists(atPath: keyPathAll.path) {
        var keyStringPath = String(format: "#EXT-X-KEY:METHOD=AES-128,URI=\"%@\"", keyPath)
        if getIV() != nil {
            keyStringPath = String(format: "#EXT-X-KEY:METHOD=AES-128,URI=\"%@\",IV=%@", keyPath,getIV()!)
        }
        header = String(format: "#EXTM3U\n#EXT-X-VERSION:3\n#EXT-X-TARGETDURATION:60\n%@\n", keyStringPath) 
    }

这样就只需要等异步下载的ts下载完成了。

--- 告警：（这里需要介绍的是：组件中只是针对下载，所以在下载之前就将本地.m3u8文件创建好了。如果是要做播放器的断点续传。这里需要每下载完一个 .ts 文件，就更新一次本地 .m3u8 文件。而且没有下载完成的ts文件，不能写入.m3u8 文件中。只能开定时器，每多少秒去复制本地文件夹一次，供给播放器使用。）

(3) 本地服务器搭建，播放本地视频。

这个我使用了 CocoaHTTPServer 这个框架来搭建本地服务器。播放器使用自己的播放器： NicooPlayer 代码：

 private func playLocalVideo() {
    server = HTTPServer()
    server.setType("_http.tcp")
    server.setDocumentRoot(NicooDownLoadHelper.getDocumentsDirectory().appendingPathComponent(NicooDownLoadHelper.downloadFile).appendingPathComponent(videoName).path)


 print("localFilePath = \(NicooDownLoadHelper.getDocumentsDirectory().appendingPathComponent(NicooDownLoadHelper.downloadFile).path)")
 
    server.setPort(UInt16(port))
    
    do {
        try server.start()
    }catch{
        print("本地服务器启动失败")
    }
    let videoLocalUrl = "\(getLocalServerBaseUrl()):\(port)/\(videoName).m3u8"
    videoPlayer.playLocalVideoInFullscreen(videoLocalUrl, "localFile", view, sinceTime: 0)
    videoPlayer.playLocalFileVideoCloseCallBack = { [weak self] (playValue) in
        // 退出时，关闭本地服务器
        self?.server.stop()
        self?.navigationController?.popViewController(animated: false)
    }
}

到这里，m3u8流视频下载和本地播放，就做完了。

🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏

如果觉得有用的朋友，希望不吝赐赠，小弟将感激不尽，并祝你合家幸福，新年快乐，万事如意。🙏，并祝你合家欢乐，新年快乐，万事如意。

🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏🙏

安装

NicooM3u8Downloader 通过 CocoaPods 提供。要安装它，只需在 Podfile 中添加以下行

pod 'NicooM3u8Downloader'

作者

yangxina, [email protected]

许可协议

NicooM3u8Downloader 在 MIT 许可证下可用。有关更多信息，请参阅 LICENSE 文件。

NicooM3u8Downloader 0.1.2

NicooM3u8Downloader 0.1.2

NicooM3u8Downloader 0.1.2

NicooM3u8Downloader

示例

要求

安装

作者

许可协议