RSLInfo  - AS3 Flash

指出載入作業截至目前為止已載入的位元組數目。因為某些下載可能失敗並移至故障轉移 URL，所以 bytesLoaded 值會隨著時間增加或減少。進度列必須調整這些值，以避免進度往後倒退。

指出載入作業截至目前為止已載入的總位元組數目。因為某些下載可能失敗並移至故障轉移 URL，所以 bytesTotal 值會隨著時間增加或減少。進度列必須調整這些值，以避免進度往後倒退。

如果下載成功完成，則傳回 true 值，如果下載尚未完成或失敗，則傳回 false 值。

傳回目前嘗試下載的 URL 索引。收到失敗事件之後，這個索引會指向失敗的 URL。索引屬於 rslURLs 與 policyFileURLs 陣列。開始下載之前，索引值為 -1。下載完成之後，索引值會等於陣列的長度，所以建議您在使用這個值存取 URL 陣列成員之前，先檢查範圍。

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEventListener(IOErrorEvent.IO_ERROR, handleErr);
         function handleErr(e:Event) {
         trace('error: ' + e);
         trace('on download of url: ' + info.rslURLs[info.currentAttemptIndex]);
         }
         

如果下載失敗則傳回 true 值，如果下載尚未完成或已成功完成，則傳回 false。如果一個 url 失敗後還會嘗試其他的故障轉移 URL，則表示 failed 屬性未設定成 true。

傳回下載 RSL 時會用到的載入器。可以是 NULL。 呼叫 load() 之後，便會建立 Loader 實體。

傳回已透過 addEntry() 新增的原則檔案 URL 陣列。將這個陣列當作是唯讀陣列。呼叫 addEntry() 來新增項目。 直接編輯這個陣列會造成不可預測的結果。

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.policyFileURLs.length; i++) {
            trace('url: ' + info.policyFileURLs[i]);
         }
         

相關 API 元素

傳回透過 addEntry() 新增的 RSL URL 陣列。將這個陣列當作是唯讀陣列。呼叫 addEntry() 來新增項目。 直接編輯這個陣列會造成不可預測的結果。

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.rslURLs.length; i++) {
            trace('url: ' + info.rslURLs[i]);
         }
         

相關 API 元素

建構函式。

新增一系列的 URL (RSL 檔案以及原則檔案)。URL 的新增順序視它們的下載優先順序而定。會先嘗試第一個 URL，而且在第一個 URL 失敗之後才會嘗試第二個 URL，依此類推。只有相符的 RSL 檔案 URL 下載之後，才會新增原則檔案。

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEntry('rsl.swf');
         myPreloader.addRSLInfo(info);
         myPreloader.start();
         

參數

開始下載 RSL。會先嘗試第一個新增的項目。當發生失敗狀況時，會嘗試後續的項目作為備份之用。