ProLoader  - AS3 Flash

包含使用 load() 或 loadBytes() 方法加载的 SWF 文件或图像（JPG、PNG 或 GIF）文件的根显示对象。

返回与正在加载的对象相对应的 ProLoaderInfo 对象。ProLoaderInfo 对象在 ProLoader 对象和加载的内容对象之间共享。ProLoaderInfo 对象提供有关加载的文件的加载进度信息和统计。

与加载相关的事件由 ProLoader 对象的 contentLoaderInfo 属性引用的 ProLoaderInfo 对象调度。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 元素

创建一个可用于加载文件（如 SWF、JPEG、GIF 或 PNG 文件）的 ProLoader 对象。调用 load() 方法可将资源加载为 ProLoader 实例的子级。然后，可以将 ProLoader 对象添加到显示列表（例如，通过使用 DisplayObjectContainer 实例的 addChild() 方法）。这样，资源在加载时会出现在舞台上。

您也可以在“offlist”模式下使用 ProLoader 实例，这样就不会将 ProLoader 实例添加到显示列表的显示对象容器中。在该模式下，Loader 实例可以用于加载包含应用程序的其它模块的 SWF 文件。

若要检测何时可以完成 SWF 文件的加载，您可以使用与 ProLoader 对象的 contentLoaderInfo 属性相关联的 ProLoaderInfo 对象的事件。此时，便可执行模块 SWF 文件中的代码以初始化和启动模块。在 offlist 模式下，还可以使用 ProLoader 实例来加载包含组件或媒体资源的 SWF 文件。同时，您可以使用 ProLoaderInfo 对象事件通知来检测组件的加载何时完成。此时，应用程序可以通过实例化代表这些组件和资源的 ActionScript 3.0 类来开始使用 SWF 文件库中的组件和媒体资源。

要确定 ProLoader 对象的状态，请监视与 ProLoader 对象的 contentLoaderInfo 属性相关联的 ProLoaderInfo 对象的以下事件：

• 在加载开始时调度 open 事件。
• 在无法加载文件或在加载过程中出现错误时，调度 ioError 或 securityError 事件。
• 在文件加载过程中会不断引发 progress 事件。
• 在文件完成下载但加载的影片剪辑的方法和属性尚不可用时调度 complete 事件。如果已加载的 SWF 文件使用 RSL 预加载，则会在 RSL 预加载完成后调度此事件。此时，在 content 属性中可以看到真实内容。
• 在可以访问加载的 SWF 文件的属性和方法，即可以开始操作加载的 SWF 文件时调度 init 事件。在 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 像素，宽度最大为 2,880 像素。

加载到 ProLoader 对象中的 SWF 文件或图像会继承该 ProLoader 对象的父显示对象的位置、旋转和缩放属性。

使用 unload() 方法可删除用此方法加载的影片或图像，或者取消正在进行中的加载操作。

可以在包含 SWF 内容的 HTML 页中设置 object 和 embed 标签的 allowNetworking 参数，防止 SWF 文件使用此方法。

使用此方法时，请考虑 ProLoader 类说明中描述的 Flash Player 安全模型。

在 Flash Player 10 和更高版本中，如果使用包含上载（由 POST 体内的“content-disposition”标头中的“filename”参数表示）的 multipart Content-Type（例如“multipart/form-data”），则 POST 操作会受应用于上载的安全规则的约束：

• 必须执行 POST 操作以响应用户启动的操作（如鼠标单击或按键）。
• 如果 POST 操作是跨域的（POST 目标与发送 POST 请求的 SWF 文件不在同一台服务器上），则目标服务器必须提供一个允许跨域访问的 URL 策略文件。

同样，对于任何 multipart Content-Type，语法必须有效（根据 RFC2046 标准）。如果语法无效，则 POST 操作受应用于上载的安全规则约束。

有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：安全性。

参数

相关 API 元素

从 ByteArray 对象中所存储的二进制数据中加载。

loadBytes() 方法是异步的。必须等待“init”事件出现才能访问已加载对象的属性。

使用此方法时，请考虑 ProLoader 类说明中描述的 Flash Player 安全模型。

参数

相关 API 元素

通过 promise 参数加载 IFilePromise 实例。promise 参数的类型使用 Object 超类而非 IFilePromise，以避免在其他播放器中出现错误。

loadFilePromise 方法使用 IFilePromise 对象并加载二进制数据。如果数据是渐进流，例如视频，则在访问加载的对象的属性之前等待“init”或 progress 事件。否则，等待 complete 事件以确保完全加载了数据。

使用此方法时，请考虑 ProLoader 类说明中描述的 Flash Player 安全模型。

参数

相关 API 元素

删除此 ProLoader 对象中使用 load() 方法加载的子项。将关联的 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 元素