ToLua 是一个用于在 Unity 中为 Lua 提供 C# 语言绑定的框架。通过 ToLua，你可以方便地将 C# 代码暴露给 Lua 脚本，并在 Lua 脚本中调用 C# 类、方法和属性。
更新流程
原理：使用AssetBundle进行资源的更新，而由于lua运行时才编译的特性，所以lua文件也可以被看成是一种资源文件（与fbx、Image等一样）可以打进ab包中
流程：
游戏运行时从服务器下载files.txt清单文件,与本地的files.txt清单文件进行对比。如果新下载的files里面的md5值与本地files的md5值不一样,或者本地清单里没有对应文件，那么就从服务器下载AB包，然后解压进行初始化
LuaState
C#能调用lua的原理就是创建了一个lua虚拟机，LuaState封装了对lua 主要数据结构 lua_State 指针的各种堆栈操作。
去反射
旧版本中lua调用C#函数是基于反射的，而现阶段是基于去反射，意思就是：把所有的c#类的public成员变量、成员函数，都导出到一个相对应的Wrap类中。而这些成员函数通过特殊的标记，映射到lua的虚拟机中，当在lua中调用相对应的函数时候，直接调用映射进去的c# wrap函数，然后再调用到实际的c#类，完成调用过程
Lua虚拟栈
C#会告诉虚拟机传入的参数和需要返回的参数，然后虚拟机开始访问栈，从栈中取出对应函数传送给Lua编译器。然后lua程序调用Lua文件全局表（Global table）查找对应函数，然后将返回参数入栈，C#再从栈中读取数据。
- 可以按1N的顺序从栈底向上，也可以从-1-N从栈顶向下
- 栈中可以存储任何数据，函数、table等，空的位置用nil表示
前置准备
使用Tolua的相关类和方法都需要调用命名空间LuaInterface，LuaState.Start 需要在tolua代码加载到内存后调用。如果使用assetbunblde加载lua文件，调用Start()之前assetbundle必须加载好。
调用lua脚本必须先创建一个lua虚拟机， 一般对于客户端，推荐只创建一个LuaState对象。如果要使用多State需要在Unity中设置全局宏 MULTI_STATE，创建步骤为：
LuaState lua = new LuaState();
加载脚本
重要方法lua.AddSearchPath ，通过此方法添加lua文件的路径，只有添加了文件路径之后，在该路径上的lua文件才可以被读取。这样DoFile跟Require函数可以只用文件名,无需写全路径。
在C#中运行一段lua脚本最简单的方法就是lua.DoString，该方法声明如下：
public object[] DoString(string chunk, string chunkName = "LuaState.DoString")
注意dofile需要扩展名, 可反复执行, 后面的变量会覆盖之前的DoFile加载的变量这里加载了就会从开始逐句执行。
LuaState.Require
public void Require(string filename)
因为Require 读取文件是会检查该文件是否被加载过，如果被加载过，则直接返回一个索引，否则则加载并返回一个索引
-
使用完lua虚拟机之后记得要销毁，具体操作如下：
-
- 先进行lua虚拟机的判空，具体做法为lua.CheckTop
- 析构掉lua虚拟机，具体做法为：lua.Dispose
C#调用lua函数
调用lua方法
我们可以把lua中的函数看成一个对象，在虚拟机初始化完成后，加载对应的lua文件，接着需要创建一个LuaFunction类型的对象来表示这个lua函数，可以通过调用：lua.GetFunction("方法名"); 来获取对应的函数对象
获取了之后就需要在C#中调用了，主要方式有两种：
- 直接调用LuaFunction类型的对象的func.Call 方法，完整声明为：
public object[] Call(params object[] args)
这种调用方法比较简单，但是有一个缺点，lua对象的内存无法被自动释放，所以当使用完这个lua函数对象之后，我们需要手动的调用LuaFunction类型的对象的func.Dispose();方法，释放掉垃圾内存，否则会造成内存泄漏！
不过选择都采用的是委托的方式，需要先进行DelegateFactory.Init()；
int num = luaFunc.Invoke<int,int>(arg);
或者是
Func<int, int> Func = luaFunc.ToDelegate<Func<int, int>>();
num = Func(123456);
- 如同案例当中的CallFunc()
int CallFunc()
{
luaFunc.BeginPCall();
luaFunc.Push(123456);
luaFunc.PCall();
int num = (int)luaFunc.CheckNumber();
luaFunc.EndPCall();
return num;
}
首先我们必须先以func.BeginPCall;开始，通过func.Push(参数)来给方法传参–通过众多重载函数来解决参数转换的gc，然后需要通过func.PCall();来运行，接着通过对应的func.Checkxxx()方法来获取返回值,最后通过func.EndPCall();结束–清楚函数调用导致的堆栈变化。整个流程比较繁琐且不易封装，不过优点是不会有垃圾内存，所以不用手动释放GC。
获取lua中的变量
创建全局变量
在lua虚拟机创建完成且初始化完毕（调用Start方法）之后，可以直接声明一个lua虚拟机的全局变量:
LuaState lua = new LuaState();
lua.Start();
lua["Objs2Spawn"] = 5;
获取全局变量格式是相同的，这点和lua相同，没有就创建否则就读取。值得注意的是对于获取的函数需要强制转换为LuaFunction：LuaFunction func = lua["TestFunc"] as LuaFunction;
获取与创建lua的table
通过调用虚拟机的方法lua.GetTable 来获取lua中的table，用LuaTable类型来储存lua中的Table，通过调用Luatable的成员方法table.AddTable来创建lua中的table , 除了通过虚拟机的GetTable方法访问之外，直接通过 LuaTable 型变量按字典的类似方法也可以调用table
LuaTable table1 = lua.GetTable("varTable");
Debug.Log("Read VarTable from lua name:{0}", table1[map.name]);//会将map.name作为整体识别为键,值为nil，不会有任何输出
table1["map.name"] = "new";// table字符串只能为key,现在为“new”
LuaTable table2 = (LuaTable)table["newmap"];
对于lua元表也能使用LuaTable的GetMetaTable()方法来获取
对于变量的获取有一点值得注意：
如同注释中的那样，[]中的string会作为整体。lua语法中，如果有一个table A，那么A.x代表的是A[“x”],表示的是由字符串 “x”索引的表， 而a[x]表示的是变量x对应的值索引的表
a = {}
x = "y"
a[x] = 10
a.x -->nil 字段“x”的值，未定义
a.y -->10, 字段“y”的值
因此如果想要C#正确获取的话，需要像下面这样：
LuaTable table = lua.GetTable("varTable");
LuaTable map = (LuaTable)table["map"];
Debugger.Log("Read varTable from lua, name: {0}", map["name"]);
对LuaTable类型的变量，在使用完后需要手动释放内存，否则会因为内存未自动释放造成内存泄漏，具体方法为调用LuaTable对象的方法table.Dispose();
GameObject
private string script =
@"
local GameObject = UnityEngine.GameObject
local ParticleSystem = UnityEngine.ParticleSystem
local go = GameObject('go')
go:AddComponent(typeof(ParticleSystem))
local node = go.transform
node.position = Vector3.one
print('gameObject is: '..tostring(go))
GameObject.Destroy(go, 2)
";
LuaState lua = null;
void Start()
{
lua = new LuaState();
lua.LogGC = true;
lua.Start();
LuaBinder.Bind(lua);
lua.DoString(script);
}
void Update(){
lua.CheckTop();
lua.Collect();
}
LuaBinder.Bind(); ——该方法需要传入一个 LuaState 类型参数。该方法会将 C# 代码中定义的类、方法、属性等绑定到该 Lua 模块中。这样，Lua 脚本就可以调用 C# 代码中定义的函数和属性，而 C# 代码也可以通过 Lua 脚本调用 Lua 中的函数和属性。
lua.Collect();——垃圾回收, 对于被自动gc的LuaFunction, LuaTable, 以及委托减掉的LuaFunction, 延迟删除的Object之类。等等需要延迟处理的回收, 都在这里自动执行
lua调用C#函数
如同 案例中的那样，
local ParticleSystem = UnityEngine.ParticleSystem
local GameObject = UnityEngine.GameObjectlocal
go = GameObject('go')
go:AddComponent(typeof(ParticleSystem))
local node = go.transform
node.position = Vector3.one
print('gameObject is: '..tostring(go))
对于UnityEngine下的一部分方法，lua中可以直接引用。
自定义脚本
对于自己实现的脚本比较麻烦，首先需要调用 LuaBinder.Bind(LuaState lua)
其次需要将自定义的类写入CustomSetting.cs文件中，你将你的自定义类加入到customTypeList数组中的末尾，如果是静态类就还需加入staticClassTypes中。然后依次点击Lua菜单中的Clear wrap files 和Gen All
自定义委托
只要需要使用到delegate字段，都要调用一次DelegateFactory.Init()，如果有自定义的委托还是要添加到CustomSetting.cs中的customDelegateList
如何给按钮动态添加监听事件？ 首先我们可以定义一个LuaHelper的静态类，在其中实现一个AddButtonClick的静态函数，NGUI中给按钮添加事件代码示例：EventDelegate.Add(UIButton.onclick, Call call)
public static void AddButtonClick(GameObject g,LuaFunction callback)
{
EventDelegate.Add(g.GetComponent<UIButton>().onClick, callback.Call);
}
在lua代码中只需找到对应的游戏物体
local helper = LuaHelper
local btn = UnityEngine.GameObject.Find("Button")
local function Onclick()
print("OnClick")
end
helper.AddButtonClick(btn,Onclick)
Lua调用C#的规范就是不在Start周期函数中去做初始化，而是包装好初始化相关的函数，在lua中获取该函数在调用
获取C#数组元素
lua想要访问C#数组有几种方法，
- 通过下标访问——这与C#中一致，而且还可以通过array.Length获取数组大小
- 通过迭代器访问——array:GetEnumerator()获取数组的迭代器，通过iter.Current获得当前的迭代器所指向的元素值，通过iter:MoveNext()将迭代器所指位置移至下一个
- 调用 array:ToTable() 实现将数组对象转化为对应的lua中的Table表的形式进行访问，注意lua数组下标从0开始
C#中获得lua函数的返回值，可以通过func.Checkxxx()来获得
比如
double arg1 = func.CheckNumber();//获得func函数double类型的返回值
string arg2 = func.CheckString();//获得func函数string类型的返回值
// 调用通用函数时需要转换类型，避免拆成多个参数
object[] objs = func.Invoke((object)array);
if (objs != null)
{
Debugger.Log("return is {0} {1} {2}", objs[0], objs[1], objs[2]);
}
ToLua框架UML
5221
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
