迅雷 API 接口说明文档 -调用迅雷自动下载

我们可以利用迅雷提供的开放API接口来自动下载文件.详细的接口说明大家可以看下面的.

先要说明一下的就是迅雷的API接口是用 .com 来调用的

首先就是脚本了，各种语言写法不同，我这里提供用vbs写的：
复制代码代码如下:
Set ThunderAgent = CreateObject("ThunderAgent.Agent.1")
Call ThunderAgent.AddTask("http://www.jb51.net/files/bjhyn.mp3","北京欢迎你.mp3","c:\a\","","http://www.readlog.cn",1,0,5)
Call ThunderAgent.CommitTasks2(1)

Call ThunderAgent.AddTask("http://file.fzone.cn/upload2/hompyFile/2007/28/921524670987.wma","放羊的星星.wma","c:\a\b\c\","",http://www.jb51.net,1,0,5)
Call ThunderAgent.CommitTasks2(1)
Set ThunderAgent = Nothing

然后就是启动迅雷了，进入工具--配置--高级，把通过IE右键菜单 “使用迅雷下载”添加任务这个选项前面的勾去掉。

保持迅雷开启状态，这时候执行上面的脚本，就不会出现那个确认添加任务的对话框了。

附：其中用到了AddTask这个方法，这个方法的参数如下：AddTask("下载地址", "另存文件名", "保存目录","任务注释","引用地址","开始模式", "只从原始地址下载","从原始地址下载线程数") 。

参数名含义

pURL目标URL，必须参数
pFileName另存名称，默认为空，表示由迅雷处理，可选参数
pPath存储目录，默认为空，表示由迅雷处理，可选参数
pComments下载注释，默认为空，可选参数
pReferURL引用页URL，默认为空，可选参数
nStartMode开始模式，0手工开始，1立即开始，默认为-1，表示由迅雷处理，可选参数
nOnlyFromOrigin是否只从原始URL下载，1只从原始URL下载，0多资源下载，默认为0，可选参数
nOriginThreadCount原始地址下载线程数，范围1-10，默认为-1，表示由迅雷处理，可选参数

附：其中用到了AddTask这个方法，这个方法的参数如下：

AddTask("下载地址", "另存文件名", "保存目录","任务注释","引用地址","开始模式", "只从原始地址下载","从原始地址下载线程数") 。

参数名含义
pURL目标URL，必须参数
pFileName另存名称，默认为空，表示由迅雷处理，可选参数
pPath存储目录，默认为空，表示由迅雷处理，可选参数
pComments下载注释，默认为空，可选参数
pReferURL引用页URL，默认为空，可选参数
nStartMode开始模式，0手工开始，1立即开始，默认为-1，表示由迅雷处理，可选参数
nOnlyFromOrigin是否只从原始URL下载，1只从原始URL下载，0多资源下载，默认为0，可选参数
nOriginThreadCount原始地址下载线程数，范围1-10，默认为-1，表示由迅雷处理，可选参数

Public Function 迅雷下载(网址 As String, Optional 保存路径 As String, Optional 另存为文件名 As String, Optional 下载注释 As String, Optional 引用页 As String, Optional 开始模式 As Long = 1, Optional 否只从原始网址下载 As Boolean = False, Optional 原始地址下载线程数 As Long = 5) As Boolean
On Error GoTo Err
Dim ThunderAgent
'nStartMode开始模式，0手工开始，1立即开始，默认为-1，表示由迅雷处理，可选参数
'nOnlyFromOrigin是否只从原始URL下载，1只从原始URL下载，0多资源下载，默认为0，可选参数
'nOriginThreadCount原始地址下载线程数，范围1-10，默认为-1，表示由迅雷处理，可选参数
Set ThunderAgent = CreateObject("ThunderAgent.Agent.1")
If ThunderAgent Is Nothing Then GoTo Err
Call ThunderAgent.AddTask(网址, 另存为文件名, 保存路径, 下载注释, 引用页, 开始模式, 否只从原始网址下载, 原始地址下载线程数)
Call ThunderAgent.CommitTasks2(1)
Set ThunderAgent = Nothing
迅雷下载 = True
Exit Function
Err:
迅雷下载 = False
End Function

Call 迅雷下载("http://www.baidu.com/index.html", "c:\", "index.html", "http://www.baidu.com")

首先确保电脑已经安装讯雷,打开VS.NET 点击菜单:项目->添加引用->COM->添加对ThunderAgent 1.0

Type Library的引用
　　1.创建讯雷调用对象

Private ThunderEng As New THUNDERAGENTLib.Agent'创建讯雷调用对象

ThunderEng.AddTask("下载地址", "另存文件名", "保存目录","任务注释","引用地址","开始模式", "

只从原始地址下载","从原始地址下载线程数") '添加下载任务

ThunderEng.CommitTasks()'提交下载任务

　　2.使用讯雷调用对象查询下载任务信息

sFileSize = ThunderEng.GetTaskInfo(txtURL.Text, "FileSize")'获取下载文件大小
sDownedSize = ThunderEng.GetTaskInfo(txtURL.Text, "CompletedSize")'获取已完成大小
sFileName = ThunderEng.GetTaskInfo(txtURL.Text, "FileName")'获取文件名

　　二、迅雷平台接口函数定义

　　获得信息

　　1. BSTR GetInfo(BSTR pInfoName)

　　功能：获得迅雷或平台相关信息

　　参数：

参数名含义
pInfoName 信息名称，有如下4种
。“ThunderExists”：迅雷是否存在
。“ThunderRunning”：迅雷是否运行
。“ThunderVersion”：迅雷版本号
。“PlatformVersion”：平台版本号

　　返回值：返回值是字符串与参数pInfoName有对应关系

参数返回值
“ThunderExists” “true”存在，“false”不存在
“ThunderRunning” “true” 运行中， “false”未运行
“ThunderVersion” 迅雷版本号 “x.x.x.x”
“PlatformVersion” 平台版本号 “x.x.x.x”

　　2. HRESULT GetInfoStruct(INT pInfo)

　　功能：获取迅雷或平台相关全部信息

　　参数：

参数名含义
pInfo 其实是THUNDER_INFO类型的结构指针，调用前把它转换为INT类型；调用后结构中将填充平台信息

，定义如下：
typedef struct _THUNDER_INFO
{
BOOL bThunderExists;
BOOL bThunderRunning;
CHAR szThunderVersion[32];
CHAR szPlatformVersion[32];
} THUNDER_INFO;

函数调用后，结构中将填充相应的信息。

　　返回值：

0 获取成功
非0 获取失败

任务操作

　　3. 加入任务

HRESULT AddTask
(BSTR pURL,
BSTR pFileName = "",
BSTR pPath = "",
BSTR pComments = "",
BSTR pReferURL = "",
INT nStartMode = -1,
INT nOnlyFromOrigin = 0,
INT nOriginThreadCount = -1);

　　功能：

　　往平台加入下载任务信息，此时尚未体现到迅雷中

　　参数：

参数名含义
pURL 目标URL，必须参数
pFileName 另存名称，默认为空，表示由迅雷处理，可选参数
pPath 存储目录，默认为空，表示由迅雷处理，可选参数
pComments 下载注释，默认为空，可选参数
pReferURL 引用页URL，默认为空，可选参数
nStartMode 开始模式，0手工开始，1立即开始，默认为-1，表示由迅雷处理，可选参数
nOnlyFromOrigin 是否只从原始URL下载，1只从原始URL下载，0多资源下载，默认为0，可选参数
nOriginThreadCount 原始地址下载线程数，范围1-10，默认为-1，表示由迅雷处理，可选参数

　　4. 开始任务

　　HRESULT CommitTaskss()

　　功能：

　　把AddTask所加入的下载任务信息真正提交到迅雷中进行下载，并从平台中删除

　　注意：如果AddTask添加的任务没有被提交没有被取消（调用CancelTasks），则Agent对象析构时会

阻塞，所以调用者不应该残留一些没有被提交或者取消的任务，以避免脚本执行者停止响应。

　　5. 取消任务

　　HRESULT CancelTasks()

　　功能：

　　取消平台中所有由AddTask所加入的下载任务信息

　　6. 查询任务信息

　　BSTR GetTaskInfo(BSTR pURL,BSTR pInfoName);

　　参数：

参数名含义
pURL 所要查询的下载URL信息
pInfoName 状态名称，有如下几种

。“Exists”：pURL是否在迅雷的任务列表
。“Path”：存储目录
。“FileName”：文件名称
。“FileSize”：文件大小
。“CompletedSize”：已下载大小
。“Percent”：下载进度
。“Status”：任务状态

　　返回值：返回值是字符串与参数pInfoName有对应关系

参数返回值
“Exists” ”true”存在，”false”不存在
“Path” 存储目录，最后带反斜线\，例：C:\TDDownload\
“FileName” 文件名称
“FileSize” 文件大小，以字节为单位，0表示大小未知
“CompletedSize” 已下载大小，以字节为单位
“Percent” 下载进度，带1位小数，例：70.0
“Status” 任务状态，有以下6种状态

。“running”：运行状态
。“stopped”：停止状态
。“failed”：失败状态
。“success”：成功状态
。“creatingfile”：正在创建数据文件
。“connecting”：正在连接

　　7. GetTaskInfoStruct(INT pTaskInfo)

　　功能：查询一个任务的所有信息

参数名含义
pTaskInfo 其实是THUNDER_TASKINFO类型的结构指针，调用前把它转换为INT类型；调用后结构中将填充

平台信息，定义如下：

typedef struct _THUNDER_TASKINFO
{
CHAR szURL[1024]; // 任务URL，预先填充
BOOL bTaskExists; // 任务是否存在，TRUE为存在
CHAR szPath[256]; // 下载的本地保存路径
CHAR szFileName[256]; // 本地文件名
ULONGLONG nFileSize; // 文件大小
ULONGLONG nCompletedSize; // 已完成的大小
CHAR szPercent[16]; // 完成的百分数，用 “56.8”的格式
CHAR szStatus[16]; // 当前状态，定义同GetTaskInfo函数
} THUNDER_TASKINFO;

调用者先填充结构中的szURL成员，来指定需要查询的任务的URL，然后等函数返回后就可以从其他成员中

取得该任务的信息。
本例所有代码

Imports System
Imports System.Text
Public Class frmThunderClass frmThunder
Private _iStartMode As Integer '讯雷任务下载开始模式
Private ThunderEng As New THUNDERAGENTLib.Agent '创建讯雷调用对象
Private Sub frmThunder_Load()Sub frmThunder_Load(ByVal sender As System.Object, ByVal e As

System.EventArgs) Handles MyBase.Load
End Sub
Private Sub btnCancel_Click()Sub btnCancel_Click(ByVal sender As System.Object, ByVal e As

System.EventArgs) Handles btnCancel.Click
Close()
End Sub
'开始下载任务
Private Sub btnStartDown_Click()Sub btnStartDown_Click(ByVal sender As System.Object, ByVal

e As System.EventArgs) Handles btnStartDown.Click
Dim iOnlyFromOrigin, iOriginThreadCount As Integer
iOnlyFromOrigin = IIf(chkOnlyFromOrigin.Checked = True, 1, 0)
iOriginThreadCount = CInt(txtOriginThreadCounts.Text)
If chkDefault.Checked Then
iOriginThreadCount = -1
End If
ThunderEng.AddTask(txtURL.Text, txtSaveAsFileName.Text, txtSaveDir.Text, txtComment.Text, _
txtReferencePage.Text, _iStartMode, iOnlyFromOrigin, iOriginThreadCount)
ThunderEng.CommitTasks()
Timer1.Enabled = True
End Sub

Private Sub radMaual_Click()Sub radMaual_Click(ByVal sender As System.Object, ByVal e As

System.EventArgs) Handles radMaual.Click, radImmediate.Click, radDefault.Click
Dim rad As RadioButton = CType(sender, RadioButton)
_iStartMode = CInt(rad.Tag)
End Sub
'当任务开始时定时查询任务下载信息
Private Sub Timer1_Tick()Sub Timer1_Tick(ByVal sender As System.Object, ByVal e As

System.EventArgs) Handles Timer1.Tick
Dim sFileSize, sDownedSize, sStatus, sFileName, sPercent As String
Try
sStatus = ThunderEng.GetTaskInfo(txtURL.Text, "Status")
sFileSize = ThunderEng.GetTaskInfo(txtURL.Text, "FileSize")
sDownedSize = ThunderEng.GetTaskInfo(txtURL.Text, "CompletedSize")
sFileName = ThunderEng.GetTaskInfo(txtURL.Text, "FileName")
lblDownedSize.Text = String.Format(lblDownedSize.Tag, sDownedSize)
lblFileSize.Text = String.Format(lblFileSize.Tag, sFileSize)
lblTaskStatus.Text = String.Format(lblTaskStatus.Tag, sStatus)
lblFilename.Text = String.Format(lblFilename.Tag, sFileName)
sPercent = ThunderEng.GetTaskInfo(txtURL.Text, "Percent") '获取下载百分比
lblProgress.Text = String.Format(lblProgress.Tag, sPercent.Remove(3, Len(sPercent) - 3))
Catch ex As Exception
End Try
End Sub
Private Sub chkOnlyFromOrigin_CheckedChanged_1()Sub chkOnlyFromOrigin_CheckedChanged_1(ByVal

sender As System.Object, ByVal e As System.EventArgs) Handles

chkOnlyFromOrigin.CheckedChanged
Panel1.Enabled = chkOnlyFromOrigin.Checked
End Sub
Private Sub GroupBox1_Enter()Sub GroupBox1_Enter(ByVal sender As System.Object, ByVal e As

System.EventArgs) Handles GroupBox1.Enter
End Sub
End Class

进入工具--配置--高级，把通过IE右键菜单 “使用迅雷下载”添加任务这个选项前面的勾去掉。
保持迅雷开启状态，这时候执行上面的脚本，就不会出现那个确认添加任务的对话框了。

迅雷 API 接口说明文档 -调用迅雷自动下载相关推荐

淘宝商品详情API接口文档调用说明
应用场景: 可通过淘宝商品详情API获取淘宝商品详情页信息,如:商品主图.价格.标题,sku,店铺名称,掌柜旺旺等等. 注意问题: 当最外层的state = false的时候则算接口失败,msg返 ...
迅雷云加速开放平台接口说明文档
迅雷云加速开放平台接口说明文档全局接口任务接口接口详细说明 XL_Init BOOLXL_Init(void) XL_UnInit BOOL XL_UnInit(void) XL_CreateT ...
python生成api文档_Django 自动生成api接口文档教程
最近在写测试平台,需要实现一个节点服务器的api,正好在用django,准备使用djangorestframework插件实现. 需求实现一个接口,在调用时,通过传递的参数,直接运行对应项目的自动化 ...
python api接口生成_Django 自动生成api接口文档教程
最近在写测试平台,需要实现一个节点服务器的api,正好在用django,准备使用djangorestframework插件实现. 需求实现一个接口,在调用时,通过传递的参数,直接运行对应项目的自动化 ...
java扫描接口_一种扫描接口并生成可调用API接口文档的方法与流程
本发明属于JavaWeb开发技术领域,涉及一种API接口文档的生成方法,尤其是一种扫描接口并生成可调用API接口文档的方法. 背景技术: API(Application Programming Int ...
JCJC错别字检测接口API测试说明文档
JCJC错别字检测接口API测试说明文档自从2016年JCJC错别字检测服务上线以来,深受广大用户的喜爱. 字根科技提供两种形式的JCJC错别字检测服务: 针对普通用户的 WEB 版本:http:/ ...
php怎么根据接口文档实现功能,CodeIgniter+swagger实现 PHP API接口文档自动生成功能...
一.安装swagger 1.首先需要有composer,没有的自行百度安装 2.下载swagger,打开网站https://packagist.org/packages/zircote/swagger ...
如何自动生成 API 接口文档 - 一份详细指南
本篇文章详细教你如何使用 Apifox 的 IDEA 插件实现自动生成接口代码.好处简单总结有以下几点: 自动生成接口文档: 不用手写,一键点击就可以自动生成文档,当有更新时,点击一下就可以自动同步接 ...
Laravel使用Apidoc注解自动生成Api接口文档
本教程从零开始搭建laravel项目,并安装Apidoc扩展及使用注解生成Api接口文档的教程,该扩展支持多应用/版本.Markdown文档.在线接口调试.接口生成器.代码模板生成器.Mock调试数 ...

迅雷 API 接口说明文档 -调用迅雷自动下载

迅雷 API 接口说明文档 -调用迅雷自动下载相关推荐

最新文章

热门文章