如何在Tizen三星智能电视上恢复失败的断点下载？

由于Tizen原生download API的resume方法仅支持恢复主动暂停的下载，无法直接处理失败后的续传，需手动基于HTTP Range请求实现断点续传逻辑，步骤如下：

1. 检查本地已下载文件的大小 #

每次启动下载前，先确认目标路径下是否存在未完成的下载文件，获取其已下载字节数：

function getExistingFileSize(filePath) {
  try {
    var file = tizen.filesystem.resolve(filePath);
    if (file.isFile) {
      return file.fileSize;
    }
  } catch (e) {
    // 文件不存在或读取失败，返回0
    return 0;
  }
  return 0;
}

2. 构造带Range请求头的下载请求 #

如果本地已有部分下载内容，在创建DownloadRequest时添加Range HTTP头，告知服务器从指定位置继续传输：

var targetUrl = "你的文件下载地址";
var saveFilePath = "文件保存路径";
var downloadedSize = getExistingFileSize(saveFilePath);

var downloadRequest = new tizen.DownloadRequest(targetUrl, saveFilePath);
if (downloadedSize > 0) {
  // 添加Range头，请求从已下载位置开始的剩余内容
  downloadRequest.httpHeader = {"Range": `bytes=${downloadedSize}-`};
}

var downloadId = tizen.download.start(downloadRequest, downloadListener);

3. 完善下载监听器逻辑 #

在监听器中记录下载进度，同时处理不同状态的后续操作：

var downloadListener = {
  onprogress: function(id, receivedSize, totalSize) {
    // 可选：将进度存储到本地，防止应用意外重启后丢失记录
    localStorage.setItem(`download_${id}_progress`, receivedSize);
  },
  oncompleted: function(id) {
    // 下载完成后清理本地进度记录
    localStorage.removeItem(`download_${id}_progress`);
  },
  onfailed: function(id, error) {
    // 下载失败无需额外操作，下次启动会自动检查本地文件大小续传
  },
  onpaused: function(id) {
    // 主动暂停场景仍可使用原生resume方法
  }
};

4. 关键注意事项 #

• 服务器兼容性：必须确保目标服务器支持HTTP Range请求（可通过HEAD请求验证响应头是否包含Accept-Ranges: bytes），否则断点续传无法生效，只能从头下载。
• 文件唯一性：启动下载前直接复用目标路径的未完成文件，避免系统生成filename(1).ext这类重复文件。
• 异常处理：需处理文件读取失败、服务器不支持Range等异常场景，可 fallback 到从头下载逻辑。

内容的提问来源于stack exchange，提问作者biometrics