HTTP 文件下载 (http.download)

声明

下载成败, 下载信息 = http.download(URL, 本地文件路径 [, 连接超时秒, 断点续传模式, 分块回调函数, 缓冲区尺寸 ])

参数及返回值

  • URL
    • 文本型,远端文件地址
  • 本地文件路径
    • 文本型,需要保存到的本地路径
  • 连接超时秒
    • 实数型,可选参数,连接超时时间,单位秒,默认 10
  • 断点续传模式
    • 布尔型,可选参数,是否需要支持断点续传,是为 true,否为 false,默认 false
  • 分块回调函数
    • 函数型
      • 可选参数,分块回调函数,每下载完一个分块都会回调一次这个函数,默认 空函数
      • 分块回调函数第一个参数为当前下载的信息,回调函数返回 true 则打断这次下载
  • 缓冲区尺寸
    • 整数型,可选参数,缓冲区大小字节数,默认自动最优配置
  • 下载成败
    • 布尔型,连接是否成功
  • 下载信息
    • 表型 或 文本型,如果连接成功则返回表型下载信息,否则返回连接失败原因文本描述

说明

-- 第二个返回值下载信息结构如下
{
    resource_size = 远端资源总字节数,
    start_pos = 本次下载从资源的开始的位置,
    size_download = 本次下载的字节数,
    speed_download = 本次下载的速度 (单位:字节/秒) ,
}

这个函数适合大文件下载,在传输的过程中停止脚本可能会缓慢
这个函数在 1.1.0-1 版以上方可使用
这个函数可能会让出,在这个函数返回之前,其它的 线程 可能会得到运行机会

简单示例

local done, info = http.download("http://192.168.31.13/1.zip", "/var/mobile/1.zip")
if (done) then
    sys.alert("如果没有意外,已经下载好了")
else
    sys.alert("连接失败:"..info)
end

复杂示例

local done, info = http.download("http://192.168.31.13/1.zip", "/var/mobile/1.zip", 10, true, function(binfo)
    local percent = math.floor(((binfo.start_pos + binfo.size_download) / binfo.resource_size) * 100)
    sys.toast("下载进度 "..percent.."%")
end, 4096 * 1024)
--
if (done) then
    if (info.start_pos + info.size_download < info.resource_size) then
        sys.alert(
            "下载中断\n本次下载 "..info.size_download.." 字节"
            .."\n从第 "..info.start_pos.." 字节开始下载"
            .."\n平均速度为 "..math.floor(info.speed_download/1024).." kB/s"
            .."\n还有剩 "..(info.resource_size - (info.start_pos + info.size_download)).." 字节"
        )
    else
        sys.alert(
            "下载完成\n本次下载 "..info.size_download.." 字节"
            .."\n从第 "..info.start_pos.." 字节开始下载"
            .."\n平均速度为 "..math.floor(info.speed_download/1024).." kB/s"
        )
    end
else
    sys.alert("连接失败:"..info)
end

:上述代码中使用了非本章函数 sys.alertsys.toast

错误信息参考

Requested range was not delivered by the server 这个错误表示服务器可能不支持断点续传,将断点续传选项设为 false 即可

results matching ""

    No results matching ""