《Cocos2d-x-3.2 Lua-tests》文件详解 之 动作管理ActionManager

直接上代码：

--给精灵、动作贴标签，标签要事先声明。标签的好处之一在下面的注释中会有讲到
local    kTagNode = 0
local    kTagGrossini = 1
local    kTagSequence = 2
--获取脚本调度器（注意，仅仅是获取），此调度器用于在每一帧调自动执行一次你设定的方法，在一些效果上跟action + repeatforever相似
local    scheduler = cc.Director:getInstance():getScheduler()
--------------------------------------------------------------------
--
-- Test1
--
--------------------------------------------------------------------
--Test1层
local function CrashTest()
    local ret = createTestLayer("Test 1. Should not crash")
    
    --调用s_pPathGrossini资源创建精灵--项目根目录下的testResource.lua统一管理所有资源，此处只需要用资源对应的名称即可
    local  child = cc.Sprite:create(s_pPathGrossini) 
    child:setPosition( 200,200 )
    ret:addChild(child, 1)

    --Sum of all action's duration is 1.5 second.
    --[[
            下面展示了精灵运行Action动画的方法：
            cc.RotateBy:create(1.5,90)创建旋转动作，完成时间1.5.秒，旋转90度
                        调用runAction()方法，以action为参数，就可以让精灵以action为规则动起来了
                        
             Sequence是动作链，即一连串的有序的动作，会被依次执行，在Sequence的最后，可以用cc.CallFunc:create()调用一个方法，
                        该方法会在Sequence中所有的动作执行完毕后，被调用
    ]]--
    child:runAction(cc.RotateBy:create(1.5, 90))
    child:runAction(cc.Sequence:create(cc.DelayTime:create(1.4),cc.FadeOut:create(1.1)))
    
    local function removeThis()
        --getParent()用来获取父容器，removeChild()用来从父容器中移除child
        --刚才试了一下把removeChild()第二个参数改成false，一样能删除，至于为什么，以后慢慢研究
        ret:getParent():removeChild(ret, true)
        Helper.nextAction()
    end

    --After 1.5 second, self will be removed.
    ret:runAction( cc.Sequence:create(cc.DelayTime:create(1.4),cc.CallFunc:create(removeThis)))
    return ret
end


--------------------------------------------------------------------
--
-- LogicTest
--
--------------------------------------------------------------------
--简单的Sequence的应用
local function LogicTest()
    local ret = createTestLayer("Logic test")
    local  grossini = cc.Sprite:create(s_pPathGrossini)
    ret:addChild(grossini, 0, 2)
    grossini:setPosition(200,200)
    local function bugMe(node)
    --新知识：停掉动画stopAllActions()，只是停掉本句代码之前的所有动作，接下来的动作还是湖继续的
        node:stopAllActions() --After this stop next action not working, if remove this stop everything is working
        node:runAction(cc.ScaleTo:create(2, 2))
    end
    grossini:runAction( cc.Sequence:create(cc.MoveBy:create(1, cc.p(150,0)) ,cc.CallFunc:create(bugMe)))
    return ret
end

--------------------------------------------------------------------
--
-- PauseTest
--
--------------------------------------------------------------------
--（动作）暂停测试
local function PauseTest()
    local ret = createTestLayer("Pause Test")
    local schedulerEntry = nil
    
    
    local function unpause(dt)
        --释放调度器，停掉动作。 在调度器的回调中释放调度器
        scheduler:unscheduleScriptEntry(schedulerEntry)
        schedulerEntry = nil
        
        local  node = ret:getChildByTag( kTagGrossini )
        local  pDirector = cc.Director:getInstance()
        
        --getActionManager()封装了多种管理Action的方法，上面的StopAllActions()是其中之一
        --resumeTarget,恢复，对kTagGrossini进行停止、暂停等相关的操作之后，须调用resumeTarget()，之后才能继续被操作
        pDirector:getActionManager():resumeTarget(node)
    end
    --事件函数
    local function onNodeEvent(event)
        if event == "enter" then
            --layer的载入事件，做以下事情：
            local  s = cc.Director:getInstance():getWinSize()
            local  l = cc.Label:createWithTTF("After 3 seconds grossini should move", "fonts/Thonburi.ttf", 16)
            ret:addChild(l)
            l:setAnchorPoint(cc.p(0.5, 0.5))
            l:setPosition( cc.p(s.width / 2, 245) )
            
            local  grossini = cc.Sprite:create(s_pPathGrossini)
            ret:addChild(grossini, 0, kTagGrossini)
            grossini:setPosition(cc.p(200,200))
            
            local  action = cc.MoveBy:create(1, cc.p(150,0))

            --是不是对下面两句比较陌生，其实它们可以合并：
            --cc.Director:getInstance():getActionManager():addAction(action,grossini,true),懂了吧，一切动作由导演管理！
            local  pDirector = cc.Director:getInstance()
            pDirector:getActionManager():addAction(action, grossini, true)
            
            --启动脚本调动器，设置相应函数unpase，每3.0秒执行一次，。false还没弄清楚 - -！
            schedulerEntry = scheduler:scheduleScriptFunc(unpause, 3.0, false)
            
        --layer退出内存时，也要释放掉调度器
        elseif event == "exit" then
            if schedulerEntry ~= nil then
                scheduler:unscheduleScriptEntry(schedulerEntry)
            end
        end
    end
    --看代码也是要找入口的，这个是主要的入口
    --首先，给层注册节点事件
    ret:registerScriptHandler(onNodeEvent)
    return ret
end

--------------------------------------------------------------------
--
-- RemoveTest
--
--------------------------------------------------------------------

--这个层结构比较简单，从上到下。
--本例要点是：给Sprite和Sequence贴标签，然后与针对性地操作。
--贴标签，你能够在一个local方法中访问另一个local方法中的贴有标签的local变量
local function RemoveTest()
    local ret = createTestLayer("Remove Test")
    local  l = cc.Label:createWithTTF("Should not crash", "fonts/Thonburi.ttf", 16)
    local  s = cc.Director:getInstance():getWinSize()
    ret:addChild(l)
    l:setAnchorPoint(cc.p(0.5, 0.5))
    l:setPosition( cc.p(s.width / 2, 245))
    --上面是操作层面的布局

    --创建一个动作
    local  pMove = cc.MoveBy:create(2, cc.p(200, 0))
    --一个方法
    local function stopAction()
        local  pSprite = ret:getChildByTag(kTagGrossini)
        pSprite:stopActionByTag(kTagSequence)
    end
    --callfunc绑定上面的那个方法
    local callfunc = cc.CallFunc:create(stopAction)
    
    --将动作和方法集结到Sequence中，Sequence中最后可以放一个回调方法，上面有提到，这次不解释
    local  pSequence = cc.Sequence:create(pMove,callfunc)
    --给Sequence贴个标签
    pSequence:setTag(kTagSequence)
    
    --创建精灵pChild
    local  pChild = cc.Sprite:create(s_pPathGrossini)
    pChild:setPosition( 200, 200 )
    --把精灵放到层中，并设置层级为1，贴个kTagGrossini的标签
    ret:addChild(pChild, 1, kTagGrossini)
    
    --pChild运行pSequence
    pChild:runAction(pSequence)
    return ret
end


--------------------------------------------------------------------
--
-- ResumeTest
--
--------------------------------------------------------------------
--恢复动作  测试
local function ResumeTest()
    local ret = createTestLayer("Resume Test")

    local schedulerEntry = nil
    local function resumeGrossini(time)
        --首先，释放脚本调度器
        scheduler:unscheduleScriptEntry(schedulerEntry)
        --将schedulerEntry回归原始值
        schedulerEntry = nil
        
        --//关键点：用标签取出Sprite，然后，导演喊：“Action”，Sprite开始按照之前设定好的动作表演（运动）。。。
        local  pGrossini = ret:getChildByTag(kTagGrossini)
        local  pDirector = cc.Director:getInstance()
        pDirector:getActionManager():resumeTarget(pGrossini)
    end


    local function onNodeEvent(event)
        if event == "enter" then
            local  l = cc.Label:createWithTTF("Grossini only rotate/scale in 3 seconds", "fonts/Thonburi.ttf", 16)
            ret:addChild(l)
            local  s = cc.Director:getInstance():getWinSize()
            l:setAnchorPoint(cc.p(0.5, 0.5))
            l:setPosition( s.width / 2, 245)
            
            --建精灵
            local  pGrossini = cc.Sprite:create(s_pPathGrossini)
            ret:addChild(pGrossini, 0, kTagGrossini)
            pGrossini:setPosition(200,200)
            --绑定动作
            pGrossini:runAction(cc.ScaleBy:create(2, 2))
            
            --导演喊话了:"cut",然后，所有的演员停掉所有的动作
            local  pDirector = cc.Director:getInstance()
            pDirector:getActionManager():pauseTarget(pGrossini)
            --此时runAction()无效：相当于导演已经设置好动作，演员还没正式表演
            pGrossini:runAction(cc.RotateBy:create(2, 360))
            
            --启动脚本调度，3秒钟后，跳到resumeGrossini方法
            schedulerEntry = scheduler:scheduleScriptFunc(resumeGrossini, 3.0, false)
        elseif event == "exit" then
            if schedulerEntry ~= nil then
                scheduler:unscheduleScriptEntry(schedulerEntry) --退出Layer的时候，释放脚本调度器
            end
        end
    end
    --读代码的入口！！！！注册载入事件。。。
    ret:registerScriptHandler(onNodeEvent)
    return ret
end

--每个test文件是一个Scene，每一个test是一个Layer
function ActionManagerTestMain()
    cclog("ActionManagerTestMain")
    Helper.index = 1
    --开启深度测试，即允许与处于非顶层的层进行交互
    cc.Director:getInstance():setDepthTest(true)
    local scene = cc.Scene:create()

    Helper.createFunctionTable = {
        CrashTest,
        LogicTest,
        PauseTest,
        RemoveTest,
        ResumeTest
    }
    scene:addChild(CrashTest())
    scene:addChild(CreateBackMenuItem())
    return scene
end

动作的创建就跟精灵的创建一样，随时随地随便一个local就可以创建，但是动作的管理则交给Director，而Director是全局的，

这样使用：cc.Director:getInstance():getActionManager():addAction(action,grossini,true)