程序實現調用迅雷(以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);
}
}
-----不積硅步,無以至千里!