WLM3U 是一個(gè)用 Swift 實(shí)現(xiàn)的 M3U 工具。
項(xiàng)目地址 https://github.com/WillieWangWei/WLM3U
示例
clone 這個(gè)倉(cāng)庫(kù),接著執(zhí)行 pod install
命令布近,然后運(yùn)行示例項(xiàng)目绸吸。
要求
iOS | Swift |
---|---|
9.0 + | 5.0 + |
安裝
WLM3U 可通過 CocoaPods 安裝扫茅,只需將以下行添加到 Podfile 即可
pod 'WLM3U'
使用
解析 M3U 文件
let url = URL(string:"http://xxx.com/yyy.m3u8")! // M3U 文件的 URL
let size: Int = <#fileSize#> // 所有 ts 文件的總大小
WLM3U
.attach(url: url, size: size, completion: { (result) in
switch result {
case .success(let model):
model.name // yyy
model.tsArr // ts 文件數(shù)組
...
case .failure(let error):
print("attach failure " + error.localizedDescription)
}
})
下載 M3U 文件描述的 ts 文件
let url = URL(string:"http://xxx.com/yyy.m3u8")! // M3U 文件的 URL
let size: Int = <#fileSize#> // 所有 ts 文件的總大小
WLM3U
.attach(url: url, size: size)
.download(progress: { (progress, completedCount) in
progress // 當(dāng)前下載的進(jìn)度
completedCount // 下載速度( B/S )
}, completion: { (result) in
switch result {
case .success(let url):
url // ts 文件所在的目錄
case .failure(let error):
print("download failure " + error.localizedDescription)
}
})
將下載的 ts 文件合并成一個(gè)文件
let url = URL(string:"http://xxx.com/yyy.m3u8")! // M3U 文件的 URL
let size: Int = <#fileSize#> // 所有 ts 文件的總大小
WLM3U
.attach(url: url, size: size)
.download()
.combine(completion: { (result) in
switch result {
case .success(let url):
url // 合并完成后文件所在的目錄
case .failure(let error):
print("combine failure " + error.localizedDescription)
}
})
自動(dòng)獲取 ts 文件總大小
WLM3U 支持自動(dòng)獲取所有文件的總大小,只需設(shè)置 calculateSize
參數(shù)即可:
let url = URL(string:"http://xxx.com/yyy.m3u8")! // M3U 文件的 URL
WLM3U
.attach(url: url, calculateSize: true)
.download()
.combine()
獲取大小的過程是異步的芽隆,可以通過接收 TaskGetFileSizeProgressNotification
和 TaskGetFileSizeCompletionNotification
來獲取大小數(shù)據(jù)。
暫停與恢復(fù)任務(wù)
為了簡(jiǎn)化接口,WLM3U 沒有 暫停
與 恢復(fù)
的概念胚吁,它們和 取消
與 添加
是一樣的牙躺,所以:
需要暫停一個(gè)任務(wù)時(shí),調(diào)用 cancel(url: URL)
腕扶。
需要取消一個(gè)任務(wù)時(shí)孽拷,調(diào)用 cancel(url: URL)
,并通過 folder(for url: URL)
獲取到此任務(wù)緩存目錄半抱,并刪除它即可脓恕。
需要添加一個(gè)任務(wù)時(shí),調(diào)用 attach(url: URL)
窿侈。
需要恢復(fù)一個(gè)任務(wù)時(shí)炼幔,調(diào)用 attach(url: URL)
,如果本地存在之前的緩存棉磨,會(huì)自動(dòng)繼續(xù)下載剩余的文件江掩。
監(jiān)聽狀態(tài)
WLM3U 內(nèi)置了幾個(gè)狀態(tài)的通知,你可以接收這些通知來處理數(shù)據(jù):
/// 下載進(jìn)度發(fā)生變化時(shí)會(huì)發(fā)出的通知乘瓤。
public let TaskProgressNotification: Notification.Name
/// 獲取文件總大小的進(jìn)度發(fā)生變化時(shí)會(huì)發(fā)出的通知环形。
public let TaskGetFileSizeProgressNotification: Notification.Name
/// 獲取文件總大小完成時(shí)會(huì)發(fā)出的通知。
public let TaskGetFileSizeCompletionNotification: Notification.Name
/// 任務(wù)完成時(shí)會(huì)發(fā)出的通知衙傀。
public let TaskCompletionNotification: Notification.Name
/// 任務(wù)發(fā)生錯(cuò)誤時(shí)會(huì)發(fā)出的通知抬吟。
public let TaskErrorNotification: Notification.Name
播放下載的文件
AVPlayer 與 WLM3U 暫不支持播放本地 ts 文件,這里提供兩個(gè)簡(jiǎn)單可行的替代方案统抬。
使用 GCDWebServer 搭建本地服務(wù)
引入 GCDWebServer 庫(kù):
pod "GCDWebServer"
創(chuàng)建本地 HTTP 服務(wù)來提供下載好的 ts 文件:
let server = GCDWebServer()
let path = <#folderPath#> // ts 文件所在的本地目錄
server.addGETHandler(forBasePath: "/",
directoryPath: path,
indexFilename: "file.m3u8",
cacheAge: 3600,
allowRangeRequests: true)
server.start()
使用 AVPlayer 來播放本地服務(wù)提供的 ts 文件:
let url = URL(string: "http://localhost:\(server.port)/file.m3u8")
let player = AVPlayer(url: url)
使用 FFmpeg 將 ts 文件轉(zhuǎn)碼成 mp4 文件
引入 mobile-ffmpeg-full 庫(kù):
pod "mobile-ffmpeg-full"
執(zhí)行轉(zhuǎn)碼命令:
let command = "-i 'ts文件所在的路徑' 'mp4文件要保存到的路徑'"
let result = MobileFFmpeg.execute(command)
if result == RETURN_CODE_SUCCESS {
// 轉(zhuǎn)碼完成
}
接下來直接播放轉(zhuǎn)碼得到的 mp4 文件即可火本。
作者
Willie, willie.wangwei@gmail.com