lua代码详解

1、使用技巧

• 打开项目在资源管理器中找到lua文件夹，拖动到VSCode上打开项目。
• 在VSCode中左侧的放大镜按钮可以全局搜索代码，在文件中使用快捷键Ctrl+F局部搜索。
• 使用快捷键Ctrl+P可快捷打开文件，如输入main.lua。

2、结构构成

我们所有所写的代码都放到GameExtend文件夹中，其它的文件夹中的都是框架中的代码，不能直接修改，可以通过“继承”来完成。

3、基本使用

在框架中，我们使用的最多的为SceneView.lua和RollView.lua。对应场景中的SlotView/scene和SlotView/scroll。

function RollView:Initialize()
	-- 获得场景中的scroll/back/normal节点的transform
	self.normal = self:GetChild("back/normal")
	-- 获得场景中的scroll/follow节点的挂载的animator组件
	self.anim = self:GetChild("follow", ClassType.Animator)
end

在框架中，C#API在lua基本能使用

-- 修改缩放
self.normal.localScale = Vector3(1, 2, 3)
-- 隐藏该节点，注：调用方法需要使用冒号而不是点
self.normal.gameObject:SetActive(false)
-- 同样可以从transform中获取挂载的组件
self.normalAnim = self.normal:GetComponent(ClassType.Animator)
self.normalAnim:SetTrigger("trigger")

4、继承

如若继承OneRound.lua：

• 在GameExtend文件夹中新建一个OneRound.lua(名字可以不同，路径可以放到原OneRound.lua路径修改为GameExtend之后的)。
• 在继承的OneRound.lua文件中的重写方法。

-- 父类的路径
local OneRound = require "GameLogic.Module.Slot.Game.OneRound"
-- 子类名称和继承的父类OneRound
OneRound = BaseClass("OneRoundEditor", OneRound)
-- 重写父类的AlterMatrix方法
function OneRound:AlterMatrix()
-- TODD 新的逻辑
end
return OneRound

• 在GameExtend/Config/ClassData.lua中声明OneRound.lua为我们所写的路径下的（把之前的注释掉，如果有）。

OneRound = "GameExtend.Module.Slot.Game.OneRound",

5、数据通信

• 本框架使用观察者设计模式进行通信，简单来说是通过(key, value)存放订阅名和订阅内容。注册：添加键为key的方法到value集合中，通知：执行所有的键为key的订阅。
• 使用LMessage:Dispatch通知，使用LMessage:Register或self:BindEvent注册，其中self:BindEvent会多一层检测，它在表中只会有一个key的订阅。

function UIShareInterface:BindEvent(evantName, func_name)
    if not self.eventMap then
        self.eventMap = {}
    end
    if not self.eventMap[evantName] then
        self.eventMap[evantName] = LMessage:Register(evantName, func_name, self)
    end    
end

• 在SceneView.lua中会在加载后会使进度条增加，然后在LoadingController.lua处理UI显示。在全局搜索中可以看到有哪些文件注册和哪些通知的。

6、RollView和SceneView常用的方法

其中的♥表示需要重写的程度

• Initialize♥♥♥♥♥：初始化的时候调用。一般用于初始化场景中的用到的各个节点。
• OnPrepare♥♥：在加载完成之后调用。用于重连等地方使用。
• OnOneRound♥：在游戏中，点击开始一局游戏的时候调用。
• OnFinishRound♥：棋子滚动结束的时候调用，然后会调用RevealScene
• RevealScene♥♥♥：在棋子滚动结束时调用。在计算结果之前如若有啥表现都可以写到这里面。
• RevealResult♥：RevealScene之后调用，计算当前矩阵的获奖情况。一般用框架的，不需要重写。
• RevealEffect♥：在RevealResult计算获奖后选择不同的表现效果。一般用框架的，不需要重写。
• RevealSwitch♥♥♥♥♥♥：RevealResult计算的获奖结果如果有特殊奖，会跳转到免费游戏等特殊玩法中，在这里面处理转场表现。
• RevealFinish♥：一局结束之后调用。一般用框架的，不需要重写。
• RevealChess♥♥♥：棋子有多种状态，包括但不限于待机(Idle)、Respin、完成(Finish)。在改变棋子的状态的时候的回调。

7、一些常用的一些其它方法

1、GetChild

使用频率：♥♥♥♥♥♥

方法说明

通过路径获得对应的节点，或获得节点上挂载的组件。

使用

-- 获得normal/root路径下的节点的transform
self.root = self:GetChild("normal/root")
-- 获得normal/image路径下的节点上挂载的Image
self.image = self:GetChild("normal/image", ClassType.Image)

2、callback

使用频率：♥♥♥♥

方法说明

返回一个方法，通常用于回调，可以带参数。

使用

function RollView:Initialize()
	self.click = ButtonItem.New(self:GetChild("click"), self)
	self.click:AddOnClick(self.click, callback(self, "Stop", 1))
end
-- 回调方法
function RollView:Stop(idx)
end

3、Mylog

使用频率：♥♥♥♥

方法说明

以log的形式打印。

使用

MyLog("hello world")

4、DelayCall

使用频率：♥♥♥♥♥

方法说明

延时x秒后执行方法，异步的。

使用

-- 延时4秒后执行function
Globals.timerMgr:DelayCall(function ()
	self.effWinObj:SetActive(false)
end, 4)

5、Dispatch

使用频率：♥♥♥♥♥

方法说明

数据之间的通信，以RollView和SceneView为主，其它的lua文件或者他们之间相互通信都要用到。

使用

-- 通知注册了LuaEvent.SmallGame.Reveal的方法，后三个为参数。整体为从normal切换为bonus
LMessage:Dispatch(LuaEvent.SmallGame.Reveal, Const.RevealType.Switch, Const.GameRule.Normal, Const.GameRule.Bonus)

6、Pop及Push

使用频率：♥♥♥

方法说明

用抽屉的形式控制资源，有就拿，不够就new，用完就放到抽屉中。

使用

获得SlotObject下的fly资源，加载之后在回调中调它的位置之类的参数，然后用Push回收，回收到场景中的Pool节点下。

Globals.poolMgr:Pop("Slot/Main/SlotObject", "fly", callback(self, "OnLoadObject"))

function RollView:OnLoadObject(args, object)
	if object.name == "fly" then
		local trans = object.transform
		trans:SetParent(self.effectRoot)
		trans.localScale = Vector3.one * 9.6
		-- 1秒之后回收
		Globals.timerMgr:DelayCall(function ()
			Globals.poolMgr:Push("fly", object)
		end, 1)
	end
end

7、DOTween

使用频率：♥♥♥♥♥♥

方法说明

所有的动画控制表现啥的都要用DOTween，框架中的lua也是可以和C#中一样正常使用。更多使用需自行学习。

使用

-- 0.5秒缩放为1.4
self.num.transform:DOScale(Vector3.one * 1.4, 0.5)
-- 0.6秒移动到targetPos位置
self.transform:DOLocalMove(targetPos, 0.6):SetEase(EaseType.OutBounce)