包 | fl.rsl |
类 | public class RSLInfo |
继承 | RSLInfo EventDispatcher Object |
子类 | SWZInfo |
语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
addEntry()
可以(为 SWF 文件和必要的策略文件)添加一系列 URL。RSLInfo 类可以调度下列任何事件:Event.COMPLETE
、IOErrorEvent.IO_ERROR
、SecurityErrorEvent.SECURITY_ERROR
和 ProgressEvent.PROGRESS
。由于使用了故障转移,即使调度了 SecurityErrorEvents 或 IOErrorEvents,RSL 下载在 failed
属性返回 true
之前也不会失败。
相关 API 元素
公共属性
属性 | 由以下参数定义 | ||
---|---|---|---|
bytesLoaded : int [只读]
指示对于要加载的所有文件,当前已加载的字节数。 | RSLInfo | ||
bytesTotal : int [只读]
指示对于要加载的所有文件,当前已加载的总字节数。 | RSLInfo | ||
complete : Boolean [只读]
如果下载已成功完成,则返回 true 值,如果下载尚未完成或已失败,则返回 false 值。 | RSLInfo | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
currentAttemptIndex : int [只读]
返回当前尝试下载的 URL 的索引。 | RSLInfo | ||
failed : Boolean [只读]
如果下载已失败,则返回 true 值,如果下载尚未完成或已成功完成,则返回 false 值。 | RSLInfo | ||
loader : Loader [只读]
返回用于下载 RSL 的加载器。 | RSLInfo | ||
policyFileURLs : Array [只读]
返回已通过 addEntry() 添加的策略文件 URL 数组。 | RSLInfo | ||
rslURLs : Array [只读]
返回通过 addEntry() 添加的 RSL URL 数组。 | RSLInfo |
公共方法
方法 | 由以下参数定义 | ||
---|---|---|---|
RSLInfo()
构造函数。 | RSLInfo | ||
添加一系列 URL(RSL 文件和策略文件)。 | RSLInfo | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
将事件调度到事件流中。 | EventDispatcher | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
表示对象是否已经定义了指定的属性。 | Object | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
开始 RSL 下载。 | RSLInfo | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
设置循环操作动态属性的可用性。 | Object | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object | ||
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher |
属性详细信息
bytesLoaded | 属性 |
bytesTotal | 属性 |
complete | 属性 |
currentAttemptIndex | 属性 |
currentAttemptIndex:int
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
返回当前尝试下载的 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]); }
实现
public function get currentAttemptIndex():int
failed | 属性 |
loader | 属性 |
policyFileURLs | 属性 |
policyFileURLs:Array
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
返回已通过 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]); }
实现
public function get policyFileURLs():Array
相关 API 元素
rslURLs | 属性 |
rslURLs:Array
[只读] 语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
返回通过 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]); }
实现
public function get rslURLs():Array
相关 API 元素
构造函数详细信息
RSLInfo | () | 构造函数 |
public function RSLInfo()
语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
构造函数。
方法详细信息
addEntry | () | 方法 |
public function addEntry(url:String, policyFileURL:String = null):void
语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
添加一系列 URL(RSL 文件和策略文件)。URL 的添加顺序取决于其下载优先级。首先尝试添加第一个 URL,在该尝试失败之前不会尝试添加第二个,依此类推。仅当下载匹配的 RSL 文件 URL 之后,才会添加相应的策略文件。
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
参数
url:String | |
policyFileURL:String (default = null )
|
load | () | 方法 |
public function load():void
语言版本: | ActionScript 3.0 |
产品版本: | Flash CS5 |
运行时版本: | Flash Player 10.1, AIR 2 |
开始 RSL 下载。首先尝试添加的第一个条目。失败时,会尝试将后续条目作为备份。
Tue Jun 12 2018, 11:04 AM Z