c#程序实现调用迅雷
程序实现调用迅雷(以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种 ◆“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，然后等函数返回后就可以从其他成员中取得该任务的信息。 |
代码示例：
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); } }
浙公网安备 33010602011771号