1
.首先导入DLL
添加引用
->
COM
->
ThunderAgent
1.0
Type Library(前提是已安装迅雷)
或者C:/Program Files/Thunder Network/Thunder/ComDlls/ThunderAgent_Now.dll(路径可能有所不同)
2
.代码:
THUNDERAGENTLib.AgentClass agent
=
new
THUNDERAGENTLib.AgentClass();
//
创建对象
//
添加任务:下载http:
//
www.baidu.com/index.html这个文件至C:/baidu.html,
//
没有注释,没有引用,立即开始,从多资源下载,原始资源线程5
agent.AddTask(“http:
//
www.baidu.com/index.html”, “index.html”, “C://”, “”, “”, 1, 0, 5);
agent.CommitTasks2(
1
);
//
提交
3
.修改迅雷配置
此时代码部分完成,但是运行的时候会弹出窗口确认下载。
如果想跳过这个窗口,需要在迅雷里面配置:工具》配置》高级》通过IE右键菜单“使用迅雷下载”添加任务,将这项去掉就可以了
附:方法详细说明
void
AddTask(
string
pURL,
string
pFileName,
string
pPath,
string
pComments,
string
pReferURL,
int
nStartMode,
int
nOnlyFromOrigin, intnOriginThreadCount);
参数名 含义
pURL 目标URL,必须参数
pFileName 另存名称,默认为空,表示由迅雷处理,可选参数
pPath 存储目录,默认为空,表示由迅雷处理,可选参数
pComments 下载注释,默认为空,可选参数
pReferURL 引用页URL,默认为空,可选参数
nStartMode 开始模式,0手工开始,1立即开始,默认为
-
1
,表示由迅雷处理,可选参数
nOnlyFromOrigin 是否只从原始URL下载,1只从原始URL下载,0多资源下载,默认为0,可选参数
nOriginThreadCount 原始地址下载线程数,范围1
-
10
,默认为
-
1
,表示由迅雷处理,可选参数
三、迅雷的开发文档
获得信息
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,然后等函数返回后就可以从其他成员中取得该任务的信息。
使用C#调用旋风快车和迅雷下载文件
如下所示:
public
static
void
DownloadByQQ(
string
url)
{
Type qqdown;
//
类型
object
qqdowobj;
//
一个对象
object
[] parameter
=
new
object
[
6
];
//
参数,因为我们调用的方法有6和参数。 所以定义了6个
if
(url
!=
null
&&
url.Length
>
0
)
{
qqdown
=
Type.GetTypeFromProgID(“QQIEHelper.QQRightClick.
2
″);
//
从progid创建类型
qqdowobj
=
Activator.CreateInstance(qqdown);
//
然后创建实例
parameter[
0
]
=
url;
//
第一个参数是url
parameter[
1
]
=
url ;
//
第二个参数是引用url,这里我们填成一样的
parameter[
2
]
=
“www.mp3114.cn”;
//
注释信息
parameter[
3
]
=
null
;
parameter[
4
]
=
0
;
parameter[
5
]
=
null
;
qqdown.InvokeMember(“sendUrl2″, BindingFlags.InvokeMethod,
null
, qqdowobj, parameter);
//
使用invokemember调用方法
//
BindingFlags 中有很多枚举,分别是用于调用方法或者属性的设置 获取等绑定标记。 你可以参考一下msdn
}
}
//
看到这里你也许已经明白如何做了。 如果还不明白呢。 接着看一遍。 或者把代码贴到程序里单步调试一遍就自然明白啦。
public
static
void
DownloadByThunder(
string
url)
{
Type ThunderAgent;
//
= new ActiveXObject(“ThunderAgent.Agent”);
object
objThunderAgent;
object
[] parameter
=
new
object
[
14
];
if
(url
!=
null
&&
url.Length
>
0
)
{
ThunderAgent
=
Type.GetTypeFromProgID(“ThunderAgent.Agent”);
objThunderAgent
=
Activator.CreateInstance(ThunderAgent);
parameter[
0
]
=
url;
parameter[
1
]
=
“”;
parameter[
2
]
=
“”;
parameter[
3
]
=
“www.mp3114.cn”;
parameter[
4
]
=
url ;
parameter[
5
]
=
-
1
;
parameter[
6
]
=
0
;
parameter[
7
]
=
-
1
;
parameter[
8
]
=
“”;
//
strCookie
parameter[
9
]
=
“”;
parameter[
10
]
=
“”;
parameter[
11
]
=
1
;
parameter[
12
]
=
“”;
parameter[
13
]
=
-
1
;
ThunderAgent.InvokeMember(“AddTask5″, BindingFlags.InvokeMethod,
null
, objThunderAgent, parameter);
//
ThunderAgent.AddTask5(Url, “”, “”, Info, Location, -1, 0, -1, strCookie, “”, “”, 1, “”, -1);
object
[] parm
=
new
object
[
1
];
parm[
0
]
=
1
;
ThunderAgent.InvokeMember(“CommitTasks2″, BindingFlags.InvokeMethod,
null
, objThunderAgent, parm);
}
}
public
static
void
DownloadByFlashGet(
string
url)
{
Type FlashGet;
object
objFlashGet;
object
[] parameter
=
new
object
[
5
];
if
(url
!=
null
&&
url.Length
>
0
)
{
FlashGet
=
Type.GetTypeFromProgID(“BHO.IFlashGetNetscapeEx”);
objFlashGet
=
Activator.CreateInstance(FlashGet);
parameter[
0
]
=
url;
parameter[
1
]
=
“www.mp3114.cn”;
parameter[
2
]
=
url;
parameter[
3
]
=
“FlashGet”;
parameter[
4
]
=
0
;
FlashGet.InvokeMember(“AddUrlEx”, BindingFlags.InvokeMethod,
null
, objFlashGet, parameter);
}
}