[AS3]as3中load加载文件的官方说明文档
load
() | 方法 |
public function load(request:URLRequest, context:LoaderContext = null):void
语言版本 : | ActionScript 3.0 |
Player 版本 : | Flash Player 9 |
将 SWF、JPEG、渐进式 JPEG、非动画 GIF 或 PNG 文件加载到此 Loader 对象的子对象中。 如果加载 GIF 动画文件,将仅显示第一帧。 由于 Loader 对象可以只包含一个子级,因此,发出后续 load()
请求将终止先前的请求,如果仍然存在未处理的请求,则会开始新的加载。
加载到 Loader 对象中的 SWF 文件或图像会继承该 Loader 对象的父显示对象的位置、旋转和缩放属性。
使用 unload()
方法可删除用此方法加载的影片或图像,或者取消正在进行中的加载操作。
使用 load()
方法时,请考虑 Flash Player 安全模型:
- 您可以加载来自任何可访问源的内容。
- 如果执行调用的 SWF 文件位于网络沙箱中并且要加载的文件是本地的,则不允许加载。
- 如果加载的内容为 SWF 文件,那么除非可以通过调用加载的内容文件中的
Security.allowDomain()
方法来允许跨脚本排列,否则另一个安全沙箱中的 SWF 文件不能对它执行脚本操作。 - 加载为 AVM1Movie 对象的 SWF 文件(用 ActionScript 1.0 或 2.0 编写的)不能对加载为 Sprite 或 MovieClip 对象的 SWF 文件(用 ActionScript 3.0 编写的)执行跨脚本操作。 但是,可以使用 LocalConnection 类使这些文件能够互相通信。
- 如果加载的内容为图像,那么除非该 SWF 文件的域包含在该图像原始域的跨域策略文件中,否则安全沙箱之外的 SWF 文件无法访问其数据。
- 在只能与本地文件系统的内容交互的沙箱中的影片剪辑不能对只能与远程内容交互的沙箱中的影片剪辑使用脚本,反之亦然。
- 可以在包含 SWF 内容的 HTML 页中设置
object
和embed
标签的allowNetworking
参数,防止 SWF 文件使用此方法。
有关详细信息,请参阅以下部分:
- security chapter(在《ActionScript 3.0 编程》一书中)和有关 LiveDocs 的最新注释
- Flash Player 9 Security White Paper
参数
request:URLRequest — 要加载的 SWF、JPEG、GIF 或 PNG 文件的绝对或相对 URL。 相对路径必须相对于主 SWF 文件。 绝对 URL 必须包括协议引用,如 http:// 或 file:///。 文件名不能包括磁盘驱动器指定。 |
|
context:LoaderContext (default = null ) — LoaderContext 对象,它具有定义下列内容的属性:
有关完整的详细信息,请参阅 LoaderContext 类中的属性说明。 |
事件
complete: — 文件下载完成后由关联的 LoaderInfo 对象调度。 complete 事件总是在 init 事件之后调度。 |
|
httpStatus: — 在通过 HTTP 发出网络请求并且 Flash Player 可以检测到 HTTP 状态代码时,由关联的 LoaderInfo 对象调度。 |
|
init: — 在可以访问被加载的 SWF 文件的属性和方法时,由关联的 LoaderInfo 对象调度。 init 事件总是在 complete 事件之前调度。 |
|
ioError: — 在发生会导致加载操作失败的输入或输出错误时,由关联的 LoaderInfo 对象调度。 |
|
open: — 下载操作开始时由关联的 LoaderInfo 对象调度。 |
|
progress: — 在下载操作进行过程中接收到数据时,由关联的 LoaderInfo 对象调度。 |
|
unload: — 删除被下载的对象时,由关联的 LoaderInfo 对象调度。 |
引发
SecurityError — LoaderContext.securityDomain 的值必须是 null 或 SecurityDomain.currentDomain 。 这说明您只能将被加载的媒体放置在其原始的安全沙箱或您自己的安全沙箱中(后者需要策略文件)。 |
|
SecurityError — 本地 SWF 文件可能只会将 LoaderContext.securityDomain 设置为 null 。 不允许将非本地媒体导入到本地沙箱中,或者将其它本地媒体放置在除其原始沙箱以外的其它位置。 |
|
SecurityError — 如果 context 参数的 applicationDomain 或 securityDomain 属性来自不允许的域。 |
|
SecurityError — 如果本地 SWF 文件尝试使用 context 参数的 securityDomain 属性。 |
热门文章推荐
- [HLS]做自己的m3u8点播系统使用HTTP Live Streaming(HLS技术)
- [FMS]FMS流媒体服务器配置与使用相关的介绍
- [AS3]什么是M3U8,与HTML5的区别是什么
- AS2.0 让flash自适应全屏,并且不自动缩放
- [AS3]as3.0的sound类常用技巧整理
- [AS3]as3与ByteArray详解、ByteArray介绍、ByteArray用法
- 关于RTMP,RTMPT,RTMPS,RTMPE,RTMPTE协议的介绍
- [JS]分享浏览器弹出窗口不被拦截JS示例