cocos2dx-lua制作新手引导

最近在项目中负责制作新手引导，有些想法分享一下。

常见的引导类型有点击和对话(剧情)，甚至有些对话(剧情)不归属新手引导的范围，但是下文介绍的时候会涉及到剧情方面。

引导的整体逻辑

我的新手引导连贯性是使用事件派发实现，cocos2dx自带的事件派发是跟Node绑定的，所以你需要去找一个lua的事件派发(当然自己写一个更好)。下面的代码中sgEventDispatcher即为我使用的事件派发工具。

新手引导肯定是跟UI层有关联的，这个无法避免所以一定要设置合理的UI节点保证你引导的位置。我这里UI是使用cocosbuilder来拼接的，lua层解析使用的Viewbase基类。在设计UI时，我会在有引导的ccb中设置一个空的Node，并且命名为ccbNodeTutorial, 然后Viewbase解析的时候，如果检测到该节点就会在该Node的”enterTransitionFinish”事件里注册监听引导的监听函数，然后在”exitTransitionStart”取消注册。

function ViewBase:registerListener() if not tutorialMgr:getTutorialOpenState() thenreturnendself:onNodeEvent("enterTransitionFinish", function()if self.ccbNodeTutorial thensgEventDispatcher:registerEventListener("sgeNewTutorial", self.onEventAddTutorial, self)self:onNodeEvent("exitTransitionStart", self.unregisterListener, self)sgEventDispatcher:dispatchEvent("sgeStartTutorial")endend)
endfunction ViewBase:unregisterListener()sgEventDispatcher:remove("sgeNewTutorial", self.onEventAddTutorial, self)
endfunction ViewBase:onEventAddTutorial(event)if not tutorialMgr:checkCanCreateTutorialView(self) thenreturnendapp:showSwallowLayer()local node = display.newNode():addTo(self)performWithDelay(node, function()tutorialMgr:processNormalTutorial(self)end, delayTime)
end

然后在每次新手引导完成，或者是加载一个含有可引导节点的时候，或者达到指定的条件(比如等级达到)，都会派发一个新的引导事件，有时候会收到多次派发事件，需要做好筛选。

新手引导主要考虑的问题：

新手引导中途断开怎么办？
新手引导阻止触摸怎么实现？
新手引导一连串的引导怎么实现？
新手引导如果有特殊的触发条件？
新手引导如果有特殊场景的引导？

新手引导中途断开处理

新手引导设计一般是按照一定的时间轴进行的，策划配表的时候可以按照一步一步来配置，但是每一步引导一般属于实现某个功能引导的一部分，可以按照对所属的功能引导把引导步数进行分组。配置示例：

    [1] = {index = 1, part = 1, type = 2, finish = 1, dialog = 901, receiver = "ccb/WelcomeScene.ccbi", },[2] = {index = 2, part = 2, type = 1, finish = 1, receiver = "ccb/Gate.ccbi", target = "ccbNodeEnterGate", targetCallback = "onBtnEnterGate", },

然后在存档的时候只存储分组的字段，每次进入游戏都是取出该分组的第一步进行引导。但是在实际引导过程中，我们需要知道当前的具体引导索引，必须设置一个字段来记录当前的引导索引。新手引导管理类的初始化方法，self.baseInfo.curTutorialPart即为存档的引导分组，self.curIndex即为当前引导的具体索引：

function Ref:ctor()self.baseInfo = data.baseInfoself.guiding = falseself.pause = falseself.tutorial = tutorialApi:getTutorialInfoByPart(self.baseInfo.curTutorialPart)-- 判断引导是否开启if self.tutorial == nil thenself.state = stateOffelseself.state = stateOnself.curIndex = self.tutorial.indexend--注册监听sgEventDispatcher:registerEventListener("sgeStartTutorial", self.onEventStartTutorial, self)sgEventDispatcher:registerEventListener("sgeEndTutorial", self.onEventEndTutorial, self)
end

当引导完成时的处理：

function Ref:onEventEndTutorial()self.guiding = false--检查引导是否完成if self:checkTutorialEndCondition() thenself:processTutorialFinished()else--引导未完成重新进行该分组的引导self.tutorial = tutorialApi:getTutorialInfoByPart(self.baseInfo.curTutorialPart)self.curIndex = self.tutorial.indexself:dispatchTutorialEvent()end
end--处理引导完成
function Ref:processTutorialFinished()local lastTutorial = self:getCurrentTutorialInfo()self.curIndex = self.curIndex + 1if lastTutorial.finish == 1 thenself.baseInfo.curTutorialPart = self.baseInfo.curTutorialPart + 1endif self:getCurrentTutorialInfo() ~= nil thenself:dispatchTutorialEvent()else-- 特殊引导完成if lastTutorial.special == 1 thenself.baseInfo.specialTutorial[lastTutorial.part] = 1self.curIndex = self.backUpIndexself:dispatchTutorialEvent()elseself:tutorialAllFinished()endend
end

新手引导阻止触摸怎么实现？

在引导点击层中注册触摸监听事件，然后在onTouchBegan， onTouchEnded中处理

--[[创建一个全屏阻止触摸的层，点击在指定范围内才会响应onTouchEnded方法，调用点击的回到方法。self.swallow是因为有时候可能需要点击到下层，如果不需要可以去掉。
]]
function Ref:onTouchBegan(touch, event)local touchPoint = touch:getLocation()local touchPos = self:getParent():convertToNodeSpace(touchPoint)local swallow = self.swallowif not swallow thenif cc.pGetDistance(touchPos, self.pos) > 50 thenswallow = trueelseswallow = falseendendreturn swallow
endfunction Ref:onTouchEnded(touch, event)local touchPoint = touch:getLocation()local touchPos = self:getParent():convertToNodeSpace(touchPoint)if cc.pGetDistance(touchPos, self.pos) < 50 thenself:processTutorialComplete()end
endfunction Ref:processTutorialComplete()if self.callback thenself.callback()endsgEventDispatcher:dispatchEvent("sgeEndTutorial")self:removeSelf()
end

新手引导一连串的引导怎么实现？

就是通过事件派发实现，但是有许多细节需要处理。比如两次引导之间如果快速点击出现问题怎么办？
我的解决方法是Node接收到合理的引导事件的时候创建一个全屏阻止触摸的layer，然后引导层出现之后移除该layer.

新手引导如果有特殊的触发条件？

local tutorialMap =
{[1] = "onGuidingClick",[2] = "onGuidingStory",
}-- 开始处理普通引导
function Ref:processNormalTutorial(view)if self:getIsGuidingTutorial() or self.pause or not self:checkTutorialStartCondition() thenreturnendlocal tutorial = self:getCurrentTutorialInfo()if tutorial.voice thenaudio:preloadAudio(string.format(tutorialAudioPath,tutorial.voice))endlocal funcName = tutorialMap[tutorial.type]local callback = handler(self, self[funcName])local arg = callback(tutorial, view)self:pushTutorial(tutorial.type, arg)
end

在self:checkTutorialStartCondition()检查引导配置里配置的引导条件是否满足，比如等级，未达到等级则不能进行引导。

新手引导如果有特殊场景的引导？

这个也可以理解为正常引导流程以外的引导。依然走的是正常引导的流程，不过需要把之前的引导进度保存起来，特殊引导走完之后再恢复回来。因为修改的是内存中self.curIndex的值，所以不需要考虑特殊引导进行中游戏中断的情况。

-- 开始处理特殊引导
function Ref:processSpecialTutorial(view, type)if self.baseInfo.specialTutorial[type] ~= nil thenreturnendself.backUpIndex = self.curIndexlocal specialTutorial = tutorialApi:getTutorialInfoByPart(type)self.curIndex = specialTutorial.indexself.tutorial = self:getCurrentTutorialInfo()self.pause = falseself:processNormalTutorial(view)
end