ProLoader  - AS3 Flash

包含使用 load() 或 loadBytes() 方法載入的 SWF 檔案或影像檔 (JPG、PNG、或 GIF) 的根顯示物件。

傳回與載入中物件相對應的 ProLoaderInfo 物件。ProLoader 物件與載入的內容物件會共用 ProLoaderInfo 物件。ProLoaderInfo 物件會提供與載入檔案相關的載入進度資訊與統計資料。

與載入有關的事件都會由 ProLoaderInfo 物件 (由 ProLoader 物件的 contentLoaderInfo 屬性所參照) 來傳送。contentLoaderInfo 屬性設定為有效的 ProLoaderInfo 物件，即使在內容載入之前也一樣，這樣您就能在載入之前，將事件偵聽程式加入物件中。

若要偵測載入 SWF 時未捕捉到的錯誤，請使用 ProLoader.uncaughtErrorEvents 屬性，不要使用 ProLoader.contentLoaderInfo.uncaughtErrorEvents 屬性。

注意 contentLoaderInfo 屬性會傳回 ProLoaderInfo 物件。ProLoaderInfo 不是 LoaderInfo 的子類別，無法讓您以隱含方式轉換為父類別。因此，請務必將您的類型宣告從 LoaderInfo 更改為 ProLoaderInfo。

是一個物件，當這個 ProLoader 物件之 SWF 檔案的程式碼發生未處理的錯誤時，這個物件就會傳送 uncaughtError 事件。在任何 try..catch 區塊外面發生錯誤時，或傳送的 ErrorEvent 物件沒有註冊偵聽程式時，就會發生未捕捉到的錯誤。

當此物件相關的 SWF 載入完成之後，就會建立這個屬性。直到 uncaughtErrorEvents 屬性變成 null 為止。在僅有 ActionScript 的專案中，您可以在執行 SWF 檔案主要類別的建構函數期間或之後存取此屬性。

在不支援的播放程式中存取這個 ProLoader 屬性會產生錯誤。傳回 EventDispatcher 物件，而非 UncaughtErrorEvents 物件，以避免在不支援的播放程式中產生錯誤。

相關 API 元素

建立一個 ProLoader 物件，可用來載入檔案 (如 SWF、JPEG、GIF，或是 PNG 檔)。呼叫 load() 方法，將資源做為 ProLoader 實體的子系載入。接著，您可以將 ProLoader 物件加入顯示清單 (例如，您可以使用 DisplayObjectContainer 實體的 addChild() 方法)。資源會在載入「舞台」時顯示。

您也可以在「清單外」使用 ProLoader 實體，也就是說，不要將它加入至顯示清單中的顯示物件容器。在這種模式裡，您可以使用 Loader 實體載入包含額外應用程式模組的 SWF 檔案。

若要偵測 SWF 檔案是否已經完成載入，您可以使用與 ProLoader 物件的 contentLoaderInfo 屬性關聯之 ProLoaderInfo 物件的事件。在這個階段，可以執行 SWF 檔案模組中的程式碼來初始化並起始模組。 在「清單外」模式中，您也可以使用 ProLoader 實體來載入包含組件或媒體資源的 SWF 檔案。同樣，您也可以使用 ProLoaderInfo 物件事件通知來偵測組件是否已經完成載入。在這個階段，應用程式會實體化代表這些元件與資源的 ActionScript 3.0 類別，以使用 SWF 檔案元件庫的組件與媒體資源開始動作。

若要判斷 ProLoader 物件的狀態，請監視下列與 ProLoader 物件之 contentLoaderInfo 屬性關聯的 ProLoaderInfo 物件事件：

• 開始載入時，會傳送 open 事件。
• 如果無法載入檔案，或者載入程序當中發生錯誤，便會傳送 ioError 或 securityError 事件。
• 在載入檔案的過程中，會持續觸發 progress 事件。
• 當檔案下載完成，但是尚未取得載入的影片片段的方法和屬性之前，會傳送 complete 事件。如果載入的 SWF 檔案使用 RSL 預先載入，則這個事件會在 RSL 預先載入完成後傳送。現在，實際內容可以在 content 屬性中取得。
• 一旦取得了載入的 SWF 檔案之屬性與方法，便會傳送 init 事件，方便您開始操作載入的 SWF 檔案。 這個事件會在 complete 處理常式之前傳送。 在串流 SWF 檔案時，init 事件的發生時間會比 complete 事件提早很多。 在大部分的情況下，請使用 init 處理常式。如果載入的 SWF 檔案使用 RSL 預先載入，則這個事件會在 RSL 預先載入完成後傳送。現在，實際內容可以在 content 屬性中取得。

相關 API 元素

取消 ProLoader 實體目前正在進行的 load() 方法作業。

將 SWF、JPEG、漸進式 JPEG、不含動畫的 GIF，或 PNG 檔載入此 ProLoader 物件的子物件中。如果載入內含動畫的 GIF 檔案，則只會顯示第一個影格。 由於 ProLoader 物件只能包含一個子系，當您後續發出 load() 要求時，會終止上一個要求 (如果上一個要求正等候執行的話)，然後開始新的載入作業。

注意：在 AIR 1.5 和 Flash Player 10 中，載入的影像大小上限為 8,191 像素寬度或高度，且像素總計不得超過 16,777,215 像素 (因此，如果載入的影像寬度為 8,191 像素，則其高度上限為 2,048 像素)。若為 Flash Player 9 和 AIR 1.1 及其更早版本，高度和寬度的上限都是 2,880 像素。

載入 ProLoader 物件的 SWF 檔案或影像會繼承 ProLoader 物件之上層顯示物件的位置、旋轉與縮放屬性。

請使用 unload() 方法，將使用此方法載入的影片或影像移除，或是取消正在進行中的載入作業。

您可以拒絕 SWF 檔使用這個方法，方式是在包含 SWF 內容的 HTML 網頁中，設定 object 和 embed 標籤的 allowNetworking 參數。

當您使用這個方法時，請考慮 ProLoader 類別說明中所述的 Flash Player 安全性模型。

在 Flash Player 10 和更新版本中，如果您使用包含上載 (由 POST 主體中 "content-disposition" 檔頭的 "filename" 參數指示) 的多部分 Content-Type (例如 "multipart/form-data")，POST 作業會受限於上載所套用的安全性規則：

• 必須執行 POST 作業，以回應使用者啟動的動作 (例如按下滑鼠或按下按鍵)。
• 如果 POST 作業會跨越網域 (POST 目標與傳送 POST 要求的 SWF 檔不在同一部伺服器上)，目標伺服器必須提供允許跨網域存取的 URL 原則。

此外，多部分的 Content-Type 語法必須有效 (符合 RFC2046 標準)。如果語法無效，POST 作業會受限於上載所套用的安全性規則。

如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。

參數

相關 API 元素

載入儲存在 ByteArray 物件中的二進位資料。

loadBytes() 方法是非同步的方法。在存取載入物件的屬性前，您必須等候 "init" 事件。

當您使用這個方法時，請考慮 ProLoader 類別說明中所述的 Flash Player 安全性模型。

參數

相關 API 元素

透過 promise 參數載入 IFilePromise 實體。promise 參數的類型使用 Object 父類別而非 IFilePromise，以避免其他播放程式發生錯誤。

loadFilePromise 方法接受 IFilePromise 物件並載入二進位資料。若資料為視訊之類的漸進式串流，請在存取載入物件的屬性之前，等待 "init" 或進度事件。否則，請等待完整的事件，以確認完整載入資料。

當您使用這個方法時，請考慮 ProLoader 類別說明中所述的 Flash Player 安全性模型。

參數

相關 API 元素

移除使用 load() 方法載入 ProLoader 物件的子系。與 ProLoaderInfo 物件關聯的 property 會重設為 null。由於其他物件不見得會參照此子系，因此不一定會移除此子系；然而，此子系將不再屬於 ProLoader 物件的子系。

在您取消載入 SWF 子檔案時，最好的方法就是明確地關閉任何位於 SWF 子檔案物件 (例如 LocalConnection、NetConnection、NetStream，與 Sound 物件) 中的串流。 否則，SWF 子檔案中的聲音可能會繼續播放，就算取消載入 SWF 子檔案也是一樣。 若要關閉 SWF 子檔案中的串流，請將事件偵聽程式加入至 unload 事件所偵聽的子系。 當父輩呼叫 ProLoader.unload() 時，unload 事件便會傳送到子系。下列程式碼將向您說明所應採取的方式：

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

相關 API 元素