as3中addFrameScript的用法

jekeyhui99

1.  适用范围：addFrameScript用于给MovieClip对象添加帧代码。
只有MovieClip及其子类才能使用这个功能，Sprite等不行。
一般是为了给多帧的动画动态添加帧代码，有时候不希望在原动画里直接写帧代码，或者同一段动画在执行时需要有不同的控制逻辑。

2.  基本用法：
asdoc里只有简短的说明：flash.display.MovieClip.addFrameScript(...parameters):void
可以看出需要传入动态参数，这个参数列表必须是偶数个。
用法如下：
mc.addFrameScript(frameIndex, function);


其中frameIndex就是你要加入帧脚本的帧。
这里值得注意的是，这里的frameIndex是从0开始的，而不是像gotoAndStop()函数是从1开始的，这里需要将实际的帧减1才是正确的。

写一段代码public class DemoClass
{
        public function DemoClass()
        {
                var mc:MovieClip;        //mc是多帧动画
                        ....
                        
                mc.addFrameScript(0, function():void
                {
                        execute.call(null, mc);
                });
        }
        
        private function execute(_mc:MovieClip):void
        {
                //对_mc的操作
        }
}

输出结果是：
currentFrame: 1 / totalFrames: 34
currentFrame: 1 / totalFrames: 34

虽然动画在内存中不断循环播放，但是帧代码只执行了一次，而且都是在第一帧执行的。显然这是没法用的，很多人容易犯这个错误，直接给帧代码一段执行函数。第二个参数要传递函数的类型，而不是引用。

修改其中两句为：
mc.addFrameScript(0, traceFrame);//这条语句给第一帧加入了帧代码，0代表第一帧。
mc.addFrameScript(mc.totalFrames - 1, traceFrame);//给最后一帧添加帧代码

给不同帧添加代码可以合并在参数里：
mc.addFrameScript(0, function1, 1, function2, .... mc.totalFrames - 1, functionX);

注意：
1). 对同一帧重复添加帧代码，新的帧代码会自动替换旧的。

2). 通过jellyfish.addFrameScript(frameIndex, null)的方法可以清除frameIndex帧的代码。

3). 如果参数不匹配会报错：
jellyfish.addFrameScript(0, function1, 1);
Error #2001: 指定的参数太少；当前为 3，应该为 4。

4). 如果frameIndex不是数字，默认给第一帧添加帧代码。如果与某一帧对应的代码不是合法的函数类型，而是执行语句，则会在第一帧执行之前执行一遍。

5). 如果给不合法帧添加代码，则都会自动过滤public class DemoClass
{
        public function DemoClass()
        {
                var mc:MovieClip;        //mc是多帧动画
                        ....
                        
                mc.addFrameScript(0, function():void
                {
                        execute.call(null, mc);
                });
        }
        
        private function execute(_mc:MovieClip):void
        {
                //对_mc的操作
        }
}

这一段给-100,100帧添加帧代码的语句会被无视。中间两条能正常执行。


3.  给帧代码传参。
     因为addFrameScript的参数传递的是函数类型，不是函数引用，因此不能传参。
     通过内联函数的形式可以给外部传递参数过去。public class DemoClass
{
        public function DemoClass()
        {
                var mc:MovieClip;        //mc是多帧动画
                        ....
                        
                mc.addFrameScript(0, function():void
                {
                        execute.call(null, mc);
                });
        }
        
        private function execute(_mc:MovieClip):void
        {
                //对_mc的操作
        }
}
或者用这种形式就不需要把参数传递过去了：public class DemoClass
{
        public function DemoClass()
        {
                var mc:MovieClip;        //mc是多帧动画
                        ....
                                
                function execute():void
                {
                        //对mc的操作
                }        
                mc.addFrameScript(0, execute);
        }
}
4. 不推荐使用addFrameScript，addFrameScript是flash的隐藏方法，与EnterFrame在底层实现机制是一样的。EnterFrame事件完全能够实现它所能做的事情，可能写起来代码会稍微多几行。就像setTimeOut能够完全被Timer替代一样。
    所以最好还是不要用addFrameScript了。

转载：关于 addFrameScript函数的纠结