open.thunderurl.com Open in urlscan Pro
101.226.28.202  Public Scan

URL: http://open.thunderurl.com/
Submission: On October 12 via manual from US — Scanned from DE

Form analysis 0 forms found in the DOM

Text Content

迅雷下载 JS-SDK

 * 指南
   * 简介
   * 调用方法
   * 联系我们
 * 更新日志


迅雷下载 JS-SDK


简介

> 调用【迅雷下载JS-SDK】可以让用户在您的网页中,使用迅雷下载您提供的文件。借助迅雷强大的数据传输技术,能够有效提升下载速度,同时降低您的服务器带宽成本。

 * 您只需要使用开放的【迅雷下载 JS-SDK】,就可以将网页中由您指定的 URL 自由、自动地转换为迅雷下载软件可以更快响应的链接。
 * 【迅雷下载JS-SDK】支持多种下载链接,包括HTTP、HTTPS、FTP、ed2k、magnet、thunder等。
 * 【迅雷下载JS-SDK】支持多种操作系统,包括Windows、Android、iOS、macOS,并且针对不同品牌、型号的设备和浏览器进行优化和适配,保证正常使用,因此您无需考虑访问设备的兼容问题。

我们承诺不在脚本中加入任何广告推广或恶意代码,并且将不断开发更加强大的功能供大家使用。因此我们建议您保持调用 open.thunderurl.com 域名的脚本文件。

> 您可以点击这里查看示例页面。


调用方法


引入 JS 文件

在您的网页中加入如下代码:

<script src="//open.thunderurl.com/thunder-link.js"></script>

使用相对协议 //,能自动识别当前网页的协议,例如当您的网页使用 HTTPS 协议时,会自动引用 HTTPS 协议的 thunder-link.js 文件。


全新用法(推荐)

调用 thunderLink.newTask 方法创建下载任务。

// 创建单个任务
thunderLink.newTask({
  downloadDir: '', // 指定当前任务的下载目录名称,迅雷会在用户剩余空间最大的磁盘根目录中创建这个目录。【若不填此项,会下载到用户默认下载目录】
  tasks: [{
    name: '', // 指定下载文件名(含扩展名)。【若不填此项,将根据下载 URL 自动获取文件名】
    url: '' // 指定下载地址【必填项】
  }]
});

当 tasks 字段指定多个任务时,会创建批量任务。

// 创建批量任务
thunderLink.newTask({
  downloadDir: '', // 指定批量任务的下载目录名称,迅雷会在用户剩余空间最大的磁盘根目录中创建这个目录。【若不填此项,会下载到用户默认下载目录】
  taskGroupName: '', // 指定任务组名称,可将批量任务合并成类似BT任务的【任务组】,迅雷将在下载目录中创建同名子文件夹保存所有下载文件。【推荐填写。若不填此项,迅雷下载列表会显示所有本次创建的下载任务,可能会使用户的下载列表显得杂乱】
  excludePath: '', // 如果您希望批量下载的文件在用户本地保持与服务器上相同的文件目录结构,可以指定排除URL的前缀,迅雷会根据被排除前缀后的URL路径,创建文件夹保存对应的文件。【本项需配合taskGroupName使用,通常用于下载绿色版游戏或程序。若不填此项,将把所有文件都放置于同一层下载目录中】
  installFile: '', // 指定批量任务中的安装程序或主程序,该任务组下载完成后,用户在迅雷中双击此任务组,将运行指定的文件。该任务组的图标也将变成指定文件的图标。【本项需配合taskGroupName使用,通常用于下载绿色版游戏或程序。若不填此项,下载完成后,用户双击此任务,将打开下载文件所在的文件夹】
  runParams: '',  // 指定打开安装程序或主程序时的启动参数【视需求填写】
  createShortcut: { // 下载完成后创建桌面快捷方式。【本项需配合taskGroupName使用,通常用于下载绿色版游戏或程序。若不填此项,将不在桌面创建快捷方式】
    name: '', // 快捷方式的名称【必填】
    targetFile: '', // 快捷方式指向的任务组内的文件相对路径【必填】
    runParams: '', // 运行参数【选填】
    startIn: '', // 起始位置[选填]
    }
  threadCount:'5', // 指定原始地址线程数【一般不必填写,但某些下载地址的服务器会限制单个IP的最大同时连接数,例如部分“网盘、在线视频”网站等,此时可将此项数值设为1,从而避免被服务器断开连接】
  hideYunPan: '1' | '0', // 是否隐藏下载到云盘入口
  referer:'', // 指定迅雷发起下载请求时上报的引用页【一般不必填写,除非某些下载地址的服务器会判断引用页】
  userAgent:'', // 指定迅雷发起下载请求时上报的UA【一般不必填写,除非某些下载地址的服务器会判断UA】
  tasks: [
    {
      name: '', // 指定下载文件名(含扩展名)。【若不填此项,将根据下载 URL 自动获取文件名】
      url: '', // 指定下载地址【必填项】
      dir: '' //指定文件的下载目录,相对于当前的downloadDir目录【一般不必填写,除非某些文件的下载地址的路径不符合你的需求】
    },
    {
      name: '', // 指定下载文件名(含扩展名)。
      url: '', // 指定下载地址
      dir: '' //指定文件的下载目录,相对于当前的downloadDir目录
    }
  ]
});

> 有关【excludePath】的详细说明

如果您希望批量下载的文件保持服务器上的文件目录结构,那么可以指定排除URL的部分路径,迅雷会根据被排除后的URL路径,创建文件夹保存对应的文件。
例如批量下载URL:
http://127.0.0.1/demo/A/1.exe
http://127.0.0.1/demo/B/2.exe
如果将排除路径设为“http://127.0.0.1/”那么迅雷将在下载目录中,创建demo文件夹,并且在demo文件夹中创建A文件夹保存1.exe,创建B文件夹保存2.exe。
如果将排除路径设为“http://127.0.0.1/demo/”那么迅雷将在下载目录中,创建A文件夹保存1.exe,创建B文件夹保存2.exe。
若不填此项,将把所有文件都放置于同一层下载目录中。

> Mac迅雷3.2.8及后续的版本仅支持部分参数:tasks,taskGroupName.

需要使用installFile、createShortcut功能请先与我们取得联系,您提供下载的文件在通过安全性审查,并加入白名单后该功能才会生效。


传统用法(不推荐)

在需要使用迅雷下载的 a 标签上添加 thunder-link 类。

<a class="thunder-link" href="填写下载链接">迅雷下载</a>

调用 thunderLink 方法,生成迅雷下载链接。

thunderLink();

原理:thunderLink 方法会遍历网页中所有的 a 标签,将带有 thunder-link 类的 a 标签转换为迅雷下载链接。

【传统用法】仅适用于简单场景,若您需要实现更多需求及使用批量下载,请查看【全新用法】。


联系我们

QQ群:754251297

邮箱:sdk@xunlei.com