程序实现调用迅雷(以C#为例)
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, int nOriginThreadCount);
参数名 | 含义 |
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种 |
返回值:返回值是字符串与参数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类型;调用后结构中将填充平台信息,定义如下: |
返回值:
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 | 状态名称,有如下几种 |
返回值: 返回值是字符串与参数pInfoName有对应关系
参数 | 返回值 |
“Exists” | ”true”存在,”false”不存在 |
“Path” | 存储目录,最后带反斜线",例:C:"TDDownload" |
“FileName” | 文件名称 |
“FileSize” | 文件大小,以字节为单位,0表示大小未知 |
“CompletedSize” | 已下载大小,以字节为单位 |
“Percent” | 下载进度,带1位小数,例:70.0 |
“Status” | 任务状态,有以下6种状态 |
7. GetTaskInfoStruct(INT pTaskInfo)
功能:查询一个任务的所有信息
参数名 | 含义 |
pTaskInfo | 其实是THUNDER_TASKINFO类型的结构指针,调用前把它转换为INT类型;调用后结构中将填充平台信息,定义如下: |
使用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);
}
}