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,然後等函數返回後就可以從其他成員中取得該任務的信息。

 

使用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); 
          } 
      }

 

-----不積硅步,無以至千里!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章