下載管理員架構

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

Windows 媒體播放機下載管理員使用 COM 技術。 功能會壓縮成一組程式設計介面;您可以使用 Microsoft JScript 或 C++ 撰寫使用這些介面的程式設計程式碼。

指令碼語言會使用 物件的概念來分割程式設計功能。 DownloadManager物件模型會使用數個物件，將方法和屬性分割成邏輯組織，將語意相關函式群組在一起。 下列各節包含下載管理員物件的相關資訊。

區段	描述
關於 DownloadManager 物件	DownloadManager物件代表Windows 媒體播放機 Download Manager 的根物件。
關於 DownloadCollection 物件	DownloadCollection物件代表下載專案的集合。
關於 DownloadItem 物件	DownloadItem物件代表個別的下載要求。

 

關於 DownloadManager 物件

DownloadManager是Windows 媒體播放機下載管理員的根物件。 所有其他物件都是透過這個 物件來存取。 若要存取 DownloadManager 物件，請使用下列 JScript 語法：

var DownloadManager = external.DownloadManager;

這會建立 DownloadManager 物件的實例，然後可用來擷取子物件。 例如，下列語法會從下載集合擷取識別碼為253675的第一個專案：

var firstItem = DownloadManager.getDownloadCollection(253675).item(0);

關於 DownloadCollection 物件

DownloadCollection物件代表要下載的檔案集合。 您可以使用這個物件來判斷集合中有多少下載、從集合中移除專案、擷取特定的下載專案，以及開始新的下載。 啟動新的下載會自動將下載新增至集合。

關於 DownloadItem 物件

DownloadItem物件代表個別下載。 下載專案一律存在於下載集合中。 使用此物件來擷取下載專案的相關資訊，以及暫停、繼續或取消進行中的下載。

當您取消下載時，下載專案會保留在下載集合中。 在此情況下， downloadCollection。downloadState 會擷取值 4，這表示已取消。

您可以使用 downloadItem。進度 ，通知使用者已傳輸多少檔案，或要下載多少檔案。 您也可以使用此值來估計剩餘的時間。

相關主題

下載管理員