LoaderMax使用指导

1、SWFLoader和ImageLoader的content 和rawContent有何不同？
        content属性取得的是包含了真实内容的容器，而rawContent取得的是真实加载内容。这样做的一个主要原因是在真实的内容加载完成之前就能添加到显示列表或者添加其他的事件。

        真实内容(rawContent)可以是图片、MovieClip、Loader或者Video，所以包装的容器也提供也提供一致的对象类型。同时还提供一些非常方便的缩放和裁剪功能。所以你一般使用content属性就行了，除非你需要直接访问SWFLoader和ImageLoader加载的真实内容。

        下面提供一个简单的例子：

 

 

    var loader:SWFLoader = new SWFLoader("child.swf", 
                                          {onComplete:onLoadSWF, width:200, height:100});      

      
     //加载开始之前就可以添加到显示列表

  addChild(loader.content); 
     loader.load();    
     function onLoadSWF(event:LoaderEvent):void { 
var mc:MovieClip = loader.rawContent; //取得真实的内容并调用他的一个函数
        mc.myCustomFunction();    里调用了加载到的swf中的一个类
     }

 
   

2、随心所欲的使用单独的加载器
如下面的例子一样，如果你只是要加载一个swf文件，则可以直接使用SWFLoader而无需使用LoaderMax进行包装。
//以下方式完全将swfLoader当做类似于Loader一样用了
var loader:SWFLoader = new SWFLoader("child.swf", {onComplete:completeHandler});
loader.load();
//addChild(loader) 直接添加到显示列表没有任何问题

//用上面的代码方式就行了，不需要像下面这样
var queue:LoaderMax = new LoaderMax({onComplete:completeHandler});
queue.append( new SWFLoader("child.swf") );
queue.load();

当你有多个loader需要加载的时候才应该考虑将loader放入到LoaderMax里面。LoaderMax会管理列表中的每一个loader，汇报他们的进度。

3、在XML中定义你要加载的文件
你知道吗，XMLLoader会在你加载的XML文件中自动查找LoaderMax关联的数据，并根据你的定义自动创建正确实例来加载他们。例如，你可以在XML数据中定义两张需要自动加载的图片。

首先定义一个xml文件：

<?xml version="1.0" encoding="iso-8859-1"?> 
<data> 
     <ImageLoader url="1.jpg" name="image1" load="true" /> 
     <ImageLoader url="2.jpg" name="image2" load="true" /> 
</data>

 

下面你的加载代码：

LoaderMax.activate([ImageLoader]); //这一句其实是为了引入ImageLoader这个类
var loader:XMLLoader = new XMLLoader("data.xml", {onComplete:completeHandler,estimatedBytes:50000}); 
loader.load();

function completeHandler(event:LoaderEvent):void 
{ 
　　var image1:Bitmap = LoaderMax.getLoader("image1").rawContent; 
　　var image2:Bitmap = LoaderMax.getLoader("image2").rawContent; 
}

 

下面让我们在XML文件中定义两个LoaderMax节点，第一个自动加载一个不自动加载。在这里我们通过设置prependURLs 属性定义一个基本的url,可以让后面录入简化。

下面是需要加载的XML：

<?xml version="1.0" encoding="iso-8859-1"?> 
<data> 
    <LoaderMax name="queue1" prependURLs="http://www.greensock.com/assets/images/" load="true"> 
        <ImageLoader url="1.jpg" name="image1" width="200" height="150" scaleMode="proportionalInside" alpha="0" /> 
        <ImageLoader url="2.jpg" name="image2" width="400" height="300" scaleMode="proportionalOutside" crop="true" /> 
    </LoaderMax> 
    <LoaderMax name="queue2" prependURLs="http://www.greensock.com/assets/" load="false"> 
        <SWFLoader url="swf/child.swf" name="child" autoPlay="false" /> 
        <VideoLoader url="video/video.flv" name="video" width="400" height="300" scaleMode="stretch" autoPlay="false" /> 
    </LoaderMax>
</data>

 

接下来的ActionScript里，XMLLoader将自动解析所有的加载器，不过只会自动加载第一个LoaderMax节点中的内容，因为他的"load"属性设置为"true"。xmlloader加载完成之后，这些内容也完成了加载。我们还可以继续加载第二个LoaderMax中的内容。代码如下：

LoaderMax.activate([ImageLoader, SWFLoader, VideoLoader]); 
var loader:XMLLoader = new XMLLoader("data.xml", { onComplete:completeHandler, estimatedBytes:50000 } );

function completeHandler(event:LoaderEvent):void { 
    trace("XML and queue1 loaded!"); 
    addChild( LoaderMax.getContent("image1") ); 
    addChild( LoaderMax.getContent("image2") ); 
    //grab the LoaderMax named "queue2" that was defined in the XML and start loading it now 
//取得xml文件中名字为"queue2"的LoaderMax开始加载
    var queue2:LoaderMax = LoaderMax.getLoader("queue2"); 
    queue2.addEventListener(LoaderEvent.COMPLETE, queue2CompleteHandler); 
    queue2.load(); 
} 
    
function queue2CompleteHandler(event:LoaderEvent):void { 
    trace("queue2 loaded!"); 
}

 

4、简单的进度条设置
LoaderMax里获取精确的加载进度实在是简单到不能再简单了，你只要设置你的进度条对象bar.scaleX=progress就搞定了。

代码如下：

var queue:LoaderMax = new LoaderMax({onProgress:progressHandler}); 
//...append various loaders... 
queue.load();

function progressHandler(event:LoaderEvent):void { 
    myProgressBar.scaleX = event.target.progress; 
}

 

5、统计下载速率或者耗时
LoaderMax里每一个加载器(loader)都有一个loadTime属性，他会告诉你加载中消耗了多少时间，你也可以用来计算下载速率。

var kbps:Number = (loader.bytesLoaded / loader.loadTime) / 1024;
trace("下载速率为:"+kbps)

 

如果计算完成下载需要多长时间可以这样：

var secondsLeft:Number = (1 / loader.progress) * loader.loadTime;

 

6、让video/image/swf 的大小适应区域
这是一种比较常见的需求，有一个固定了大小的区域，你需要让加载进来的video/image/swf适应区域的大小。比如：你有一个缩略图的网格，但是你的实际图片大小与缩略图的规定大小并不一致或者是未知的。没问题，你可以直接设置图片的宽度和高度来适应你的区域大小。

var loader:ImageLoader = new ImageLoader("1.jpg", {width:200, height:100, container:this});

 

默认情况下他会通过拉伸来适应你设置的尺寸。如果你希望按照比例来缩放显示以适应区域，可以设置scaleMode属性为“proportionalInside”. 这种情况下水平或者垂直方向可能会多出空余位置，你可以设置“hAlign” and “vAlign” 属性来确定水平适应还是垂直适应（默认值都为"center"）。如果你希望改变区域的填充颜色可以设置"bgColor"属性。

下面的例子是将图片加载到一个200*100红色背景的区域中，等比缩放，并设置x和y位置属性：

var loader:ImageLoader = new ImageLoader("1.jpg", {width:200, height:100, scaleMode:"proportionalInside", bgColor:0xFF0000, container:this, x:50, y:70});

 

还有一个好处是放置图片的ContentDisplay对象会立即创建，你可以放在场景的任何位置，添加鼠标事件等等（意思就是说创建一个imageLoader实例后不用等加载就能马上设置）。例如添加一个鼠标事件可以这样来写：

loader.content.addEventListener(MouseEvent.CLICK, clickHandler); 
function clickHandler(event:MouseEvent):void { 
    trace("clicked image associated with loader: " + event.currentTarget.loader); 
}

 

重要提示：
如果你想改变区域的尺寸到缩放后的内容的尺寸，可以设置ContentDisplay的"fitWidth"和"figHeight"属性。

7、设定区域对image/video/swf进行裁剪
假设你想让一张图片等比缩放以适应到某个区域，但是不希望在区域的边缘留下空白区。怎么做？你可以首先设定scaleMode属性为"proportionalOutside"，然后将"crop"属性设置为true。这样可以使图片等比填充整个区域，并且讲超出区域的部分裁剪掉。下面给一段代码：

var loader:ImageLoader = new ImageLoader("1.jpg", {width:200, height:100, scaleMode:"proportionalOutside", crop:true, container:this, x:50, y:70});

 
8、progress 和 rawProgress有什么不同？（译者注：这个特性需要特别了解）
所有的加载器都有一个"progress"属性来显示"bytesLoades"和"bytesTotal"的比例（即进度）。但是LoaderMax类还多了一个"rawProgress"的属性，这个属性将所有的加载文件同等对待而且与文件大小无关。它在一些特定的场合下会比较有用：比如你发现你的进度条不稳定或者你想忽略文件大小的评估同时不想给你的加载器设定estimatedBytes 。

下面有个例子，可以让你充分了解"progress"和"rawProgress"在各种情景下的比较。你会发现"rawProgress"进度条不会突变，但是相对于以文件大小为计算依据的方式速度会一会儿快，一会儿慢。
点击load()按钮你可以看到"progress"非常精确并且平滑。(这是因为estimatedBytes的值是正确的)接下来你试着改变estimatedBytes的值或者删除estimatedBytes的值看一下省略的时候的运行情况。试着取消“auditSize”的复选框，可以观察“auditSize”为false的情况下是如何运行的。更多有关进度条暴增和回退的问题原因会在下一节做讲解。



9、避免进度条的抖动（暴增或者回退）
不知道你有没有在使用中遇到过进度条暴增活着回退的情况。一般在单一加载的时候不会出现这种情况，但是当你用一个LoaderMax实例去加载多个文件的一些特殊场合会发生这种情况。首先说一下原因和我所使用的方案。

为了精确的计算一组加载器总的进度，我们最关键的是需要知道每一个文件的文件大小。但是在文件还没有开始加载的时候我们如何知道要加载的大小呢？LoaderMax通过两种方式来处理：第一种——在创建你的loader的时候随意指定一个值给"estimatedBytes"属性，就像这样：

new ImageLoader("1.jpg", {estimatedBytes:26000});

 

如果你给一个加载器设定了一个"estimatedBytes"值，LoaderMax会根据这个值来计算"progress"，直到开始真正加载取到了真实的文件大小值再替换掉它。如果你所设定的值不准确，就会在修正这个文件大小值的时候出现进度条的抖动。具体现象为：如果你所设定的值比真实的文件大小值小很多，就会出现进度条的回退。如果你所设定的值比真实的文件大小值大很多，就会出现进度条的暴增现象。

LoaderMax所采用的第二种解决方式是检查真实文件。默认情况下会查找每一个子加载器是否有"estimatedBytes"设置。一旦发现没有进行设置，就会迅速开启一个URLStream取得真实的文件大小，并立刻关闭再检查下一个。全部检测完毕后，就会按照真实的文件总字节数加载并计算进度。这样做的好处是减少了你的麻烦并且会进度会非常准确。不过会要在开始下载前花费一些检查的时间。

当然你也可以关闭"auditSize"选项或者进行全局设置关闭所有加载器的"auditSize",下面是代码：

var loader:ImageLoader = new ImageLoader("1.jpg", {width:200, //turns auditing off for only this instance:
var queue:LoaderMax = new LoaderMax({auditSize:false});

//changes the default auditSize to false for all LoaderMax instances created after this point
LoaderMax.defaultAuditSize = false;height:100, scaleMode:"proportionalOutside", crop:true, container:this, x:50, y:70});

 

好了，知道了原因下面我们来看一下如何解决，这里有一些方案共你选择：
比较省事、精确、需要一点额外时间（默认）的方式
忽略

var queue:LoaderMax = new LoaderMax({onProgress:progressHandler, onComplete:completeHandler});
queue.append( new SelfLoader(this) ); //just to include the root swf in the progress calculations
queue.append( ...append your other loaders... );
queue.load();

 

12、parse()一个完整的Url数组
有时候你会希望简单的给LoaderMax一个数组，让它自己使用对应的类型去加载。可以用下面的方法来做：


var urls:Array = ["1.jpg", "video.flv", "child.swf", "audio.mp3"];

//activate the types of loaders so that parse() can recognize the appropriate extensions (only necessary once)
LoaderMax.activate([ImageLoader, VideoLoader, SWFLoader, MP3Loader]);

var queue:LoaderMax = LoaderMax.parse(urls, {onComplete:completeHandler}, {autoPlay:false});
queue.prependURLs("http://www.greensock.com/assets/"); //saves us from having to include this in every URL in the array, and makes switching servers very easy.
queue.load();

 

取得加载的内容用下面的方法：

function completeHandler(event:LoaderEvent):void {
var video:VideoLoader = LoaderMax.getLoader("http://www.greensock.com/assets/video.flv");
addChild( video.content );
video.playVideo();
}

 

13、取得代码提示和严格的数据类型
如果你不介意文件长度稍微会长一点、代码量会大一些。可以使用

var config:LoaderMaxVars = new LoaderMaxVars();
config.name = "queue1";
config.onComplete = completeHandler;
config.onProgress = progressHandler;
config.maxConnections = 1;
var queue:LoaderMax = new LoaderMax(config);

 


终于翻译完了，呵呵