更新记录

1.0.0（2026-05-28）

v-download

Android 原生 文件下载管理 UTS 插件，支持普通 HTTP 下载与 M3U8 下载合并。

功能

快速使用

import {
  startDownload,
  pauseDownload,
  resumeDownload,
  cancelDownload,
  removeDownload,
  getDownloadList,
  getDownloadTask,
  clearCompleted
} from '@/uni_modules/v-download'

// 普通文件
startDownload({
  url: 'https://example.com/video.mp4',
  fileName: 'video.mp4',
  saveDir: 'movies',
  progress: (p) => {
    console.log(p.progress, p.status, p.speed)
  },
  success: (task) => {
    console.log('任务ID', task.taskId, task.savePath)
  },
  fail: (err) => console.log(err.errMsg)
})

// M3U8（type 可省略，URL 含 .m3u8 会自动识别）
startDownload({
  url: 'https://example.com/live/index.m3u8',
  fileName: 'output.mp4',
  type: 'm3u8',
  headers: { referer: 'https://example.com', userAgent: 'Mozilla/5.0' },
  progress: (p) => { /* ... */ }
})

pauseDownload({ taskId: 'dl_xxx' })
resumeDownload({ taskId: 'dl_xxx' })
cancelDownload({ taskId: 'dl_xxx' })
removeDownload({ taskId: 'dl_xxx' })

const { list } = getDownloadList()
const task = getDownloadTask('dl_xxx')
clearCompleted()

API

startDownload(options)

同步方法

• getDownloadList() → { list: DownloadTaskInfo[] }
• getDownloadTask(taskId) → DownloadTaskInfo | null
• clearCompleted() → 清除数量

任务状态

pending · downloading · paused · completed · failed · cancelled

M3U8 说明

• 自动选择 最高码率 子播放列表
• 分片并发下载（3 线程）
• 支持 AES-128 加密（#EXT-X-KEY）
• 合并方式为 TS 分片 二进制拼接（输出 .mp4 扩展名，实质为 TS 流；多数播放器可播放）
• 如需标准 MP4 转码，需自行接入 FFmpeg

存储路径

Android/data/<包名>/files/v-download/

调试

1. HBuilderX 制作 自定义调试基座
2. 运行 pages/download/download.vue
3. 确保 manifest 含 INTERNET 权限

错误码（90 开头）

平台兼容性

uni-app(4.0)

v-download

Android 原生 文件下载管理 UTS 插件，支持普通 HTTP 下载与 M3U8 下载合并。

功能

快速使用

import {
  startDownload,
  pauseDownload,
  resumeDownload,
  cancelDownload,
  removeDownload,
  getDownloadList,
  getDownloadTask,
  clearCompleted
} from '@/uni_modules/v-download'

// 普通文件
startDownload({
  url: 'https://example.com/video.mp4',
  fileName: 'video.mp4',
  saveDir: 'movies',
  progress: (p) => {
    console.log(p.progress, p.status, p.speed)
  },
  success: (task) => {
    console.log('任务ID', task.taskId, task.savePath)
  },
  fail: (err) => console.log(err.errMsg)
})

// M3U8（type 可省略，URL 含 .m3u8 会自动识别）
startDownload({
  url: 'https://example.com/live/index.m3u8',
  fileName: 'output.mp4',
  type: 'm3u8',
  headers: { referer: 'https://example.com', userAgent: 'Mozilla/5.0' },
  progress: (p) => { /* ... */ }
})

pauseDownload({ taskId: 'dl_xxx' })
resumeDownload({ taskId: 'dl_xxx' })
cancelDownload({ taskId: 'dl_xxx' })
removeDownload({ taskId: 'dl_xxx' })

const { list } = getDownloadList()
const task = getDownloadTask('dl_xxx')
clearCompleted()

API

startDownload(options)

同步方法

• getDownloadList() → { list: DownloadTaskInfo[] }
• getDownloadTask(taskId) → DownloadTaskInfo | null
• clearCompleted() → 清除数量

任务状态

pending · downloading · paused · completed · failed · cancelled

M3U8 说明

• 自动选择 最高码率 子播放列表
• 分片并发下载（3 线程）
• 支持 AES-128 加密（#EXT-X-KEY）
• 合并方式为 TS 分片 二进制拼接（输出 .mp4 扩展名，实质为 TS 流；多数播放器可播放）
• 如需标准 MP4 转码，需自行接入 FFmpeg

存储路径

Android/data/<包名>/files/v-download/

调试

1. HBuilderX 制作 自定义调试基座
2. 运行 pages/download/download.vue
3. 确保 manifest 含 INTERNET 权限

错误码（90 开头）