RSLInfo  - AS3 Flash

Indicates the number of bytes that have been loaded thus far for all files being loaded. Because some loads may fail and go to failover URLs, the bytesLoaded value can increase or decrease over time. Progress bars must compensate for this to avoid moving backward.

Indicates the total number of bytes that have been loaded thus far for all files being loaded. Because some loads may fail and go to failover URLs, the bytesTotal value can increase or decrease over time. Progress bars must compensate for this to avoid moving backward.

Returns a value of true if the download has completed successfully and false if the download is not yet complete or has failed.

Returns the index of the URL currently attempting to download. When failure events are received, this index points to the URL that failed. The index belongs to the rslURLs and policyFileURLs arrays. Before downloading has begun, the index value is -1, After downloading has completed, it is equal to the length of the arrays, so range checking is recommended before using this value to access a URL array member.

         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]);
         }
         

Returns a value of true if the download has failed and false if the download is not yet complete or has completed successfully. The failed property is not set to true if a single url has failed and there are additional failover URLs to attempt.

Returns the loader used to download the RSL. Can be NULL. The loader instance is created after load() has been called.

Returns an array of policy file URLs that have been added via addEntry(). Treat this array as read-only. Add entries by calling addEntry(). Editing this array directly will cause unpredictable results.

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

Related API Elements

Returns an array of RSL URLs added via addEntry(). Treat this array as read-only. Add entries by calling addEntry(). Editing this array directly will cause unpredictable results.

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

Related API Elements

Constructor.

Adds a series of URLs (RSL files and policy files). The order in which the URLs are added depends on their download priority. The first URL is tried first, the second will not be tried until the first has failed, and so on. Policy files are added only when the matching RSL file URL is downloaded.

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

Parameters

Starts the RSL download. The first entry added is tried first. Subsequent entries are tried as backups as failures occur.