uniapp断点下载

uniapp断点下载实现方法

在uniapp中实现断点下载功能，可以通过以下步骤完成：

使用uni.downloadFile API uniapp提供了uni.downloadFile方法用于文件下载，结合本地存储可实现断点续传功能。关键参数包括url（文件地址）和filePath（保存路径）。

获取已下载文件大小 通过uni.getFileInfo获取本地已下载文件的大小，用于后续设置请求头Range字段。示例代码：

uni.getFileInfo({
  filePath: tempFilePath,
  success: (res) => {
    const downloadedSize = res.size
  }
})

设置Range请求头 在下载请求中添加HTTP头Range，指定从已下载位置开始继续下载：

uni.downloadFile({
  url: 'https://example.com/file.zip',
  header: {
    'Range': `bytes=${downloadedSize}-`
  },
  success: (res) => {
    if (res.statusCode === 206) {
      // 断点续传成功
    }
  }
})

保存下载进度 使用uni.setStorageSync将当前下载进度保存到本地，应用重启时可读取进度：

// 保存进度
uni.setStorageSync('downloadProgress', {
  url: fileUrl,
  downloadedSize: currentSize
})

// 读取进度
const progress = uni.getStorageSync('downloadProgress')

合并文件片段 如果服务器支持分片下载，需要将多个分片合并为完整文件。可通过uni.saveFile和文件流操作实现：

const fs = uni.getFileSystemManager()
fs.appendFile({
  filePath: finalPath,
  data: chunkData,
  success: () => {
    // 合并成功
  }
})

注意事项

• 服务器必须支持Range请求，返回206 Partial Content状态码
• 大文件下载建议分片处理，避免内存问题
• 安卓平台需注意文件存储权限问题
• iOS平台需在manifest.json中配置访问白名单

完整示例代码

let downloadTask = null

function startDownload(url) {
  const savedProgress = uni.getStorageSync(url)
  const downloadedSize = savedProgress ? savedProgress.downloadedSize : 0

  downloadTask = uni.downloadFile({
    url: url,
    header: { 'Range': `bytes=${downloadedSize}-` },
    success: (res) => {
      if (res.statusCode === 206) {
        uni.saveFile({
          tempFilePath: res.tempFilePath,
          success: (savedRes) => {
            console.log('文件保存成功', savedRes.savedFilePath)
          }
        })
      }
    }
  })

  downloadTask.onProgressUpdate((res) => {
    uni.setStorageSync(url, {
      downloadedSize: downloadedSize + res.totalBytesWritten
    })
  })
}

function pauseDownload() {
  if (downloadTask) {
    downloadTask.abort()
  }
}