更新记录

1.0.4（2026-10-23）

1. 优化加密类型的下载

1.0.3（2025-07-04）

1. 重构开放接口，改为变量实例来调用
2. 增加鸿蒙支持

1.0.2（2024-10-05）

1. 修复新版本基座回调不能持续问题

平台兼容性

uni-app(3.8.7)

uni-app x(3.8.7)

其他

m3u8HLS视频下载播放

• 开始、暂停、下载进度
• 支持多个TS视频同时下载，加快下载速度
• 支持加密key、多子码率等格式
• 支持自定义请求头

快速接入

1. 拷贝demo示例里的AndroidManifest.xml到项目根目录
2. 集成插件步骤请参考https://www.cnblogs.com/wenrisheng/p/18323027

demo里同时集成了另外两个插件(非必须，只是为了方便调试开发)：

• 本地HttpServer-静态站点-getpost请求-文件上传下载-本地HLS(m3u8)视频播放https://ext.dcloud.net.cn/plugin?id=15876 用于app本地启动http server,播放观看m3u8视频

• 工具类文件增删查改遍历图片base64转换获取设备ID钥匙串https://ext.dcloud.net.cn/plugin?id=14130 用于开发过程中，查看m3u8文件的下载情况

接口

import {
    UTSM3u8Download
} from "@/uni_modules/wrs-uts-downloadfile"
let m3u8Download = new UTSM3u8Download()

• 开始/继续下载 下载完成后，m3u8的文件路径为(下载后的m3u8文件名固定为index.m3u8): plus.io.convertLocalFileSystemURL("_download/video0") + "/index.m3u8"

let params = {}
params.saveDir = saveDir // 保存视频的目录
params.url = url // m3u8文件的下载地址
m3u8Download.downloadM3u8(params, (resp) => {
    let opt = resp.opt
    let options = resp.options
    switch (opt) {
        case "onDownloadM3u8Progress":
            let progress = resp.progress
            item.progress = Math.floor(progress * 100)
            break;
        case "onDownloadM3u8Suc":
            item.progress = 100
            this.showMsg("下载完成：" + params.url)
            break;
        case "onDownloadM3u8Fail":
            this.showMsg("下载失败:" + JSON.stringify(resp))
            break;
        default:
            break;
    }
})

• 暂停下载

let params = {}
params.url = "xxxx" // m3u8文件下载地址
m3u8Download.pauseDownloadM3u8(params)