迅雷下载 JS-SDK 用户帮助手册

Question

使用迅雷下载您网页中的文件，可以借助迅雷强大的数据传输技术有效提升下载速度，同时降低服务器的带宽压力，保证用户在下载视频、游戏等大文件时的体验。

• 您只需要使用开放的迅雷下载 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 文件。

基础用法

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

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

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

thunderLink();

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

基础用法仅适用于简单场景，若您需要更多的配置及使用批量下载，请查看高级用法。

高级用法

迅雷 9.1.49 及后续版本支持全部参数用法

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

调用 thunderLink.newTask 方法创建下载任务，同时您还可以配置任务的下载目录和任务名称。

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

当 tasks 字段指定多个任务时，会创建批量任务。批量任务还可以配置安装文件（供游戏和应用使用）和任务组名称。

// 通过参数创建批量任务
thunderLink.newTask({
  minVersion: '10.0.1.0', // 指定响应批量任务的迅雷最低版本；格式匹配：/^\d+\.\d+\.\d+(?:\.\d+)?$/ 【一般不必填写】
  downloadDir: '', // 指定当前任务的下载目录，迅雷会在用户剩余空间最大的磁盘根目录中创建这个目录。【若不填此项，会下载到用户默认下载目录】
  installFile: '', // 指定下载文件中的安装文件，下载完成后若用户选择立即安装或双击此任务，则运行此文件。【若不填此项，下载完成后，用户可打开下载文件所在的文件夹】
  runParams: '',  // 指定打开安装文件时的启动参数【一般不必填写】
  taskGroupName: '', // 指定任务组名称，将在下载目录中创建同名子文件夹保存所有下载文件。【若不填此项，将不会创建同名子文件夹保存下载文件】
  excludePath: '', // 如果您希望批量下载的文件在用户本地保持与服务器上相同的文件目录结构，可以指定排除URL的前缀，迅雷会根据被排除前缀后的URL路径，创建文件夹保存对应的文件。【若不填此项，将把所有文件都放置于同一层下载目录中】
  threadCount: 5, // 指定原始地址线程数【10.1.3及后续版本支持此功能。一般不必填写，但某些下载地址的服务器会限制单个IP的最大同时连接数，例如部分“网盘、在线视频”网站等，此时可将此项数值设为1，从而避免被服务器断开连接】
  tasks: [
    {
      name: '', // 指定下载文件名（含扩展名）。【若不填此项，将根据下载 URL 自动获取文件名】
      url: '', // 指定下载地址【必填项】
      dir: '' //指定文件的下载目录,相对于当前的downloadDir目录【10.1.3及后续版本支持此功能。一般不必填写，除非某些文件的下载地址的路径不符合你的需求】
    },
    {
      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。

若不填此项，将把所有文件都放置于同一层下载目录中。

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