Unity--XLua调用C#

Unity--XLua调用C#

由于Unity/C# 和lua是两种语言,两种语言的特性不一样,因此,如果要互相调用的话,需要第三方作桥梁. 因此,为了在Unity中/C#中使用lua的特性,需要在Unity中安装插件,Xlua/toLua作为桥梁. 通过该桥梁可以使得lua中的数据传递Unity中,Unity中的数据传递到lua中,或者进行类/成员函数/成员变量/静态函数的调用. 以下是在关系图,下图是Lua调用Unity/C#的一个大致过程, 本文主要介绍xlua在Unity中的使用以及lua如何调用C#

由于是lua调用Unity/C#,因此,许多逻辑都是在lua中书写的,在C#中准备部分数据,以便lua调用

1. lua调用C#中的类

说明: 由于C#存在类所在命名空间,因此,不同命名空间下的类可能名称是相同的,因此在使用中的是需要注意.此外,为了简写命名空间,我们可以给C#中的类名区别名. 即 CS.Namespace.ClassName 具体可以为:CS.UnityEngine.GameObject

例如:

lua 复制代码
GameObject = CS.UnityEngine.GameObject
Transform = CS.UnityEngine.GameObject.Transfrom

由于在C#中,要使用类,我们一般的方式是使用new的方式实例化对象,在lua中没有new的方式,因此在lua中使用()就相当于无参构造

例如:

lua 复制代码
local obj1 = CS.UnityEngine.GameObject()
local obje2 = CS.UnityEngine.GameObject("Go")

如前说的,我们可以取别名 因此,上面的lua代码可以写为

lua 复制代码
-- 取别名
GameObject = CS.UnityEngine.GameObject
-- 使用别名创建对象
local obj = GameObject()

使用类中的静态变量和静态方法

我们可以通过类名.的方法调用

例如:

lua 复制代码
-- 取别名
GameObject = CS.UnityEngine.GameObject
-- 实例化对象
local obj = GameObject()
-- 使用成员属性并打印出来
print(obj.transform.position)
-- 使用点的方式调用静态珊瑚
local go = GameObject.Find("Go");
-- 取别名
Debug = CS.UnityEngine.Debug
-- 调用Deug中的Log函数
Debug.Log(go.transform.position)

调用实例化对象中的成员属性和成员方法

调用成员属性的时候直接使用点的方式即可,掉用对象中的成员方法需要使用冒号:的方式进行调用. 同理,我们自己写的类也是如此.

例如:

lua 复制代码
-- 取别名
GameObject = CS.UnityEngine.GameObject
Vector3 = CS.UnityEngine.Vector3
Debug = CS.UnityEngine.Debug

--实例化对象
local obj = GameObject()

-- 调用成员函数
obj.transform:Translate(Vector3.right)

Unity中的继承了Mono的类

由于Unity的Mono本身不能通过new的方式进行实例化,因此,我们在需要通过名称是实例化GameObject的时候需要填写参数,在C#中使用的泛型的方式,但是在lua中无法使用泛型,因此,需要调用c#中的重载的方法.

例如:

lua 复制代码
GameObject = CS.UnityEngine.GameObject
local obj = GameObject("更名的GameObject")

2.lua调用C#中的枚举

lua调用C#中的枚举和调用类/类的实例中的属性是一样的. 调用自定义枚举也是如此.

例如:

lua 复制代码
-- 取别名
PrimitiveType = CS.UnityEngine.PrimitiveType
GameObject = CS.UnityEngine.GameObject
Debug = CS.UnityEngine.Debug
-- 使用Unity中的创建内置的游戏物体 -- PrimitiveType.Cube在Unity中就是枚举
local obj1 = GameObject.CreatePrimitive(PrimitiveType.Cube)

-- 自定义枚举
AnimationEnum = CS.E_AnimationEnum
local obj2 = AnimationEnum.Idle
print(obj2)

需要注意的是,我们在C#中使用枚举,是直接使用枚举对象或者枚举.枚举值进行调用,在lua中,需要转换才能被使用

转换方法如下

lua 复制代码
.__CastFrom(数字/字符串)

根据函数名称,我们知道,传入参数是一个数字,或者字符串,得到的是是一个枚举

例如:

C#中的自定义枚举

c# 复制代码
public Enum E_AnimationEnum
{
    Idle,
    Walk,
    Run,
    Jump
}

lua代码:

lua 复制代码
AnimationEnum = CS.E_AnimationEnum
local obj = AnimationEnum.Idle
print(obj) 
-- obj中是userdata,保存的是C#/C++中的原始数据

-- 数字枚举转换
local a = AnimationEnum.__CastFrom(1)
print(a)
-- 打印出来是:Idle : 0

-- 字符串转枚举
local b = AnimationEnum.__CastFrom("Jump")
print(b)
-- 打印出来是:Walk : 1

3.lua调用C#的数组/List/Dictionary

1.ua调用数组

在C#中的代码如下:

ArrayTest.cs

c# 复制代码
public Class AttayTest
{
    public int[] array = new int[9] { 1,2,3,4,5,6,7,8,9 };
}

遍历数组

在C#中使用.Length进行获得数组的长度,在lua中调用的时候也可以,因为数组基础功能了Array这个类,该类中有Length的属性,因此,在 lua中可以直接调用

lua 复制代码
-- 取别名
Debug = CS.UnityEngine.Debug
-- 实例化对象
local obj = CS.AttayTest()
-- 遍历c#中的数组
for i = 0,obj.array.Length - 1 do
	print("index: " .. obj.array[i])
end

我们已经会了遍历数组中的的元素,如何在lua中创建C#数组呢

根据上面提到的Array类的方法中,我们发现有CreateInstance函数来实现创建各种类型的数组. 该函数原型如下,且有6个重载,特家具

csharp 复制代码
public static Array CreateInstance(Type elementType,int length);
public static Array CreateInstance(Type elementType,int length1,int length2);
public static Array CreateInstance(Type elementType,int length1,int length2,int length3);
public static Array CreateInstance(Type elementType,params int[] lengths);
public static Array CreateInstance(Type elementType,int[] lengths,int[] lowerBounds);
public static Array CreateInstance(Type elementType,params long[] lengths);

这六个函数都是Array类的静态方法,用于创建指定类型和维度的数组实例。它们在System命名空间中定义,可以在C#代码中直接调用。下面是对每个函数的详细解释:

  1. CreateInstance(Type elementType,int length):
    • 这个方法创建一个一维数组,其元素类型由elementType指定,长度由length指定。
  2. CreateInstance(Type elementType,int length1,int length2):
    • 这个方法创建一个二维数组,元素类型由elementType指定,第一维的长度由length1指定,第二维的长度由length2指定。
  3. CreateInstance(Type elementType,int length1,int length2,int length3):
    • 这个方法创建一个三维数组,元素类型由elementType指定,第一、二、三维的长度分别由length1length2length3指定。
  4. CreateInstance(Type elementType,params int[] lengths):
    • 这个方法是最通用的创建数组的方法,可以创建任意维度的数组。elementType指定元素类型,lengths是一个参数数组,每个元素对应数组的一个维度长度。
  5. CreateInstance(Type elementType,int[] lengths,int[] lowerBounds):
    • 这个方法与上一个方法类似,但它允许指定每个维度的下界(即数组的起始索引)。lengths指定每个维度的长度,lowerBounds指定每个维度的起始索引。
  6. CreateInstance(Type elementType,params long[] lengths):
    • 这个方法与CreateInstance(Type elementType,params int[] lengths)类似,但它接受long类型的参数,允许创建长度非常大的数组。

根据CreateInstance的第一个参数,我了解到需要传入一个泛型,因此 我们在lua中创建数组的时候,需要指定类型

由于xlua对泛型的支持不算友好,因此,需要使用typeof()来指定类型

例如:

lua 复制代码
-- 给系统中Int32的类型取别名
Int = CS.System.Int32
-- 使用重载函数创建一维数组
local obj = CS.System.Array.CreateInstance(typeof(Int),8)
-- 遍历以为数组
for i = 0,obj.Length - 1 do
	obj[i] = i * 2
	print("lua创建c#中的数组,index = " .. i .. "value = ".. obj[i])
end

2.lua调用List

在C#的代码TestList.cs中有一个空的list

csharp 复制代码
public class TestList
{
    public List<int> list = new List<int>();
}

在lua中调用list的成员函数

lua 复制代码
-- 实例化对象
local obj = CS.TestList()

-- 添加数据
obj.list: Add(1)
obj.list: Add(10)
obj.list: Add(100)

-- 遍历list
for i = 0,obj.list.Count - 1 do
	print("list: " .. obj.list[i])
end

在lua中创建list对象

版本1->旧版本

使用CS.System.Collections.Generic的方式构建lList,但还不是List类的实例

例如: 构建了一个List的类,list中的类型System.String,即系统中的String类型

lua 复制代码
CS.System.Collections.Generic["List`1[System.String]"]

使用该类构建list对象

lua 复制代码
-- 使用()构建list对象
CS.System.Collections.Generic["List`1[System.String]"]()
-- 或者分开使用
List_String = CS.System.Collections.Generic["List`1[System.String]"]
-- 实例化对象
local stringList = List_String()

版本2->新版本

省去了"List1[System.String]"这一串,使用CS.System.String`代替

lua 复制代码
local List_String = CS.System.Collections.Generic.List(CS.System.String)
-- 实例化对象
local list = List_String()
-- 添加数据
list3: Add("Pi")
list3: Add("Banana")
list3: Add("chese")
-- 打印数据
print(list[1])
print(list[2])

3.lua调用Dictionary

在C#的代码TestDictionary.cs中有如下代码. 其中包含了一个key为string类型的键,int类型的Value

c# 复制代码
public class TestDictionary
{
    // Dictionary
    public Dictionary<string,int> dic = new Dictionary<string,int>();
}

调用c#中的字典

lua 复制代码
-- 实例化对象
local obj = CS.TestDictionary()
-- 给c#中的字典添加数据
obj.dic: Add("One",1)
obj.dic: Add("two",2)
obj.dic: Add("three",3)
obj.dic: Add("four",4)

Lua中遍历C#中的字典. 在C#中遍历的时候使用的是foreach通过迭代器的方式遍历,在lua中没有foreach,因此只能使用for配送pais来遍历

lua 复制代码
-- 实例化对象
local obj = CS.TestDictionary()
-- 给c#中的字典添加数据
obj.dic: Add("One",1)
obj.dic: Add("two",2)
obj.dic: Add("three",3)
obj.dic: Add("four",4)
-- 遍历字典

-- 遍历使用for循环,c#中使用的是foreach
for k,v in pairs(obj.dic) do
	print(k,v)
end

在lua中创建Dictionary,使用CS.System.Collections.Generic.Dictionary(key类型,value类型)来构建字典

例如,在lua创建一个string为key,Vector3为value的键Dictionary,lua代码如下

lua 复制代码
-- 取别名
Vector3 = CS.UnityEngine.Vector3
String = CS.System.String
-- 构建字典类
local Dic_String_Vector3 = CS.System.Collections.Generic.Dictionary(String,Vector3)
-- 实例化字典
local dic2 = Dic_String_Vector3()
-- 添加数据
dic2: Add("Zero",Vector3.Zero)
dic2: Add("Forward",Vector3.rorward)
dic2: Add("Right",Vector3.right)
-- 遍历字典
for k,v in pairs(dic2) do
	print(k,v)
end

[注意] : 在C#中可以通过[key]的方式来获取值,例如:dic["Zero"]获取值,但是在lua中无法使用该方法,需要使用固定写法get_Item(键值)

例如:

lua 复制代码
print(dic2:get_Item("Right"))

同时,还有另外一种获取值的方式TryGetValue(键名)

print(dic2: TryGetValue("Forward"))

使用TryGetValue的方式获得值,先返回的是一个bool值,表示是否得到了key对应的值,如果能得到Value,然后返回对应的值

修改自定中的值,通过set_Item的方式修改值

例如:

lua 复制代码
-- 使用功能set_Item来设置值
dic: set_Item("Right",Vector3.left)
print(dic:get_Item("Right"))

4.lua调用扩展方法

在C#中,在不改变源代码的情况下给我们自己的类添加其他功能,我们是通过c#的特性添加扩展方法,因此,在lua中也是可以可以调用c#中的扩展方法.

在C#代码中有如下代码:

c# 复制代码
[XLua.LuaCallCSharp]
public static class Tools
{
    // 拓展方法 必须是静态的,且有this指针
    // 这是一个扩展方法,它为 TestExtend 类型添加了一个名为 ToUpperFirstLetter 的新方法
    public static string ToUpperFirstLetter(this TestExtend obj)
    {
        // 如果字符串不为空,则转换首字母为大写
        if (!string.IsNullOrEmpty(obj.s1))
        {
            return char.ToUpper(obj.s1[0]) + obj.s1.Substring(1);
        }
        return obj.s1;
    }
}

public class TestExtend
{
    public string s1 = "i am writing this letter to inform you of my recent situation";

    public string s2 = "we've been experiencing a hurricane here recently,so we've been very busy lately";

    // 静态成员方法
    public static void Greating()
    {
        Debug.Log("Daily Greating");
    }
    
    public void SendLetter(string userName,string emailAddress,string subject)
    {
        Debug.Log("sendign the letter with the subject:" + subject + "to user: " + userName + "(" + emailAddress + ")");
    }

}

在lua中的代码如下:

lua 复制代码
TestExtend = CS.TestExtend

-- 先调用静态方法
TestExtend.Greating()

-- 实例化对象
local obj = TestExtend()
-- 调用成员方法
obj:SendLetter("Caron4","xxx@gmail.com","Daily Greetings")

-- 调用扩展方法
-- 需要再添加xLua特性
-- [XLua.LuaCallCSharp]
-- 建议添加上,可以提升速度,因为lua调用c#是通过反射的方式调用的 
local str = obj:ToUpperFirstLetter();
print(str)

5.lua调用C#中含有ref out修饰参数的函数

在C#中,refout 是两个用于参数传递的关键字,它们允许方法通过引用传递参数,而不是通过值传递。这种传递方式允许方法修改传入参数的值,并在方法外部保持这些更改. ref和out的区别,在于ref需要初始化,out不需要初始化。

在lua中如调用呢? 以下是C#中的代码。

c# 复制代码
public class TestREfOut
{
    // 普通函数
    public void NormalFun(int a,int b,int c)
    {
        Debug.Log($"a = {a},b = {b},c = {c}");
    }

    // 被ref修饰的参数-需要初始化
    public int RefFun(int a,ref int b,ref int c,int d)
    {
        b = a + d;
        c = a - d;
        return 200;
    }

    // 被out修饰的参数-不需要初始化
    public int OutFun(int a,out int b,out int c,int d)
    {
        b = a;
        c = d;
        return 300;
    }

    // 被ref 和 out同时修饰的函数
    public int RefOutFun(int a,ref int b,out int c)
    {
        b = a * 10;
        c = a * 20;
        return 400;
    }
}

以下是lua中的调用代码,在调用的术时候,需要注意C#中的函数是否有返回值,如果有返回值,返回的第一个参数是函数的返回值,而不是被ref或者out修饰的值

lua 复制代码
-- 别名
TestREfOut = CS.TestREfOut

local obj = TestREfOut()

-- 调用普通函数
obj: NormalFun(100,200,300);

-- 调用ref的函数
local a,b,c = obj:RefFun(10,0,0,20)
print("ref返回值" .. a) 	-- 打印 200
print("ref返回值" .. b)	-- 打印 30
print("ref返回值" .. c) 	-- 打印 10

-- 调用out的函数
-- C#中的函数签名 4个参数,1个返回值
-- public int RefFun(int a,ref int b,ref int c,int d)
-- public int OutFun(int a,out int b,out int c,int d)
local a,b,c = obj:OutFun(10,20)
print("out返回值" .. a) 	-- 打印 300
print("out返回值" .. b)	-- 打印 10
print("out返回值" .. c) 	-- 打印 20

-- 混合调用ref和out的函数

-- C#中的函数签名 3个参数,1个返回值
-- public int RefOutFun(int a,out int b,ref int c)
local a,b,c = obj:RefOutFun(10,0)
print("refout返回值" .. a) 		-- 打印 400
print("refout返回值" .. b)		-- 打印 100
print("refout返回值" .. c)		-- 打印 200

6.lua调用C#中的重载函数

在C#中我们可以使用名称相同,参数类型不同和返回值不同来进行实现重载函数. 在lua中中调用,需要特备注意.

以下是C#中的代码

csharp 复制代码
public class TestOverride
{
    // 普通函数
    public int Calc()
    {
        return 100;
    }
    // 有返回值,有两个参数的重载
    public int Calc(int num1,int num2)
    {
        return num1 + num2;
    }
    // 有返回值和一个参数的重载
    public int Calc(int num)
    {
        return num;
    }
    // 有返回值和一个类型不同的参数的重载
    public float Calc(float num)
    {
        return num;
    }
}

在lua是支持重载函数的,但是由于lua中的中保存数字的类型只有一种,因此我们在调用饭后float/double等类型的重载函数需要注意. 以下是具体代码.

lua 复制代码
-- 取别名
TestOverride = CS.TestOverride
-- 实例化对象
local obj = TestOverride();

-- 调用普通的成员函数
local a = obj:Calc()
print("a = ".. a)
local b = obj:Calc(100,200)
print("b = " ..b)
-- a和b都被打印出来,说明是支持重载的

调用精度较高的重载函数的时候,,会出现问题

例如:

lua 复制代码
-- 取别名
TestOverride = CS.TestOverride
-- 实例化对象
local obj = TestOverride();
-- 调用重载函数
local c = obj:Calc(300)
print("c = " .. c)
-- 调用精度较高的重载函数
local d = obj:Calc(300.569)
print("d = ".. d)
-- 的打印的结果为0  是因为lua中的数字存储的类型只有number一种类型

-- 因此不建议使用精度不同的重载函数

为了将解决进度的问题,我们需要使用反射来获取类型

先通过GetMethod获取类中的方法,在GetMethod中实则参数的类型,将函数转换一下,然后在使用,注意转换为float的时候, 类型需要填写为CS.System.Single

例如:

lua 复制代码
local m1 =typeof(CS.TestOverride):GetMethod("Calc",{typeof(CS.System.Int32)})
lua 复制代码
-- 取别名
TestOverride = CS.TestOverride
-- 实例化对象
local obj = TestOverride();
-- 转换重载函数
local m1 = typeof(CS.TestOverride):GetMethod("Calc",{typeof(CS.System.Int32)})
local m2 = typeof(CS.TestOverride):GetMethod("Calc",{typeof(CS.System.Single)})

-- 一般只转换一次,然后重复使用
local f1 = xlua.tofunction(m1)
local f2 = xlua.tofunction(m2)

-- 调用的时候,如果是成员方法的话,第一个参数传对象
-- 如果是静态方法的话,就不用传对象
print(f1(obj,10))
print(f2(obj,10.2))

7.Lua调用C#中的委托和事件

Unity中的游戏开发中,大型项目往往是lua项目,而游戏中的UI的交互往往是通过lua调用的. 因此UI的交互这种事情可以交给lua来做,比如,按钮点击,滑块调节.

以下是C#中的代码

c# 复制代码
public class TestDelegate
{
    // 申明委托
    public UnityAction del;
}

由于委托/事件具有添加,移除,执行和销毁等基本功能,添加和移除使用+=/-=来操作的,由于在lua总没有复合运算符,因此我们子啊进行添加事件或者移除事件的时候需要做一些修改. 调用委托和C#中的一样

以下是有关委托的相关的操作

lua中的代码如下

lua 复制代码
-- 别名
TestDelegate = CS.TestDelegate

local obj = TestDelegate();
-- lua中的函数,待添加到委托中
local fun = function()
	print("lua函数Fun")
end

-- 第一次使用/添加的时候需要等号=赋值
obj.del = fun
-- 使用 = 也算添加进去了一次函数
print("lua使用+给C#的委托添加函数")
obj.del = obj.del + fun
obj.del = obj.del + fun
-- 调用
obj.del()

-- 添加匿名函数

obj.del = obj.del + function ()
	print("lua给C#委托添加了匿名函数")
end

-- 执行委托
obj.del()
-- 移除委托中的函数
print("lua端移除委托中的函数")
obj.del = obj.del - fun
obj.del = obj.del - fun
obj.del = obj.del - fun

-- 执行委托
obj.del()
-- 发现还是打印的的"lua给C#委托添加了匿名函数"
-- 这说明,委托中无法移除匿名函数,但是可以使用nil来清空

-- 清空委托
print("lua将C#中的委托置为nil等于清空了委托,也包括匿名函数")
obj.del = nil

以下是有关事件的相关的操作

csharp 复制代码
public class TestEvent
{
    // 声明事件
   public event UnityAction eventAction;
    
    public void DoEvent()
    {
        if(eventAction!= null)
        {
            // 执行事件
            eventAction();
        }
    }
	// 清空事件
    public void ClearEvent()
    {
        eventAction = null;
        Debug.Log("事件清空完毕");
    }
}

lua调用C#中的事与调用委托非常不一样

以下是lua中调用C#中的事件的代码

lua 复制代码
-- 取别名
TestEvent = CS.TestEvent
-- 实例化对象
local obj = TestEvent();
-- 待添加到事件中的函数
local fun2 = function()
	print("lua给C#事件添加函数")
end

-- lua中使用c#事件添加函数,有点类似与调用成员方法 冒号: 事件名("+",函数变量)

obj:eventAction("+",fun2)
-- 调用的时候不能直接调用,需要在c#写函数,lua调用函数的方式调用事件

obj:DoEvent()
-- 添加匿名函数
obj:eventAction("+",function()
	print("Lua给事件添加匿名函数")
end)
obj:DoEvent()

print("移除事件事件中的函数")
obj:eventAction("-",fun2)
obj:eventAction("-",fun2)
-- 移除后再执行事件
obj:DoEvent()

-- lua中不管是委托还是事件,不建议使用添加匿名函数
-- lua中的事件,需要清空的话,需要在C#中写一个函数进行清空
-- 然后在lua中调用,换句话说,lua不支持直接清空c#的事件
print("lua调用C#中清空事件的函数")
-- 清空事件
obj:ClearEvent();

8.lua调用C#中的二维数组

这是为了不充电前面的3的相关内容. 在C#中使用二维数组很简单,但是在lua中调用需要做一些改变

以下是C#中的代码

csharp 复制代码
public class TestTWoDimAttary
{
    // 一个二维数组
    public int[,] array = new int[2,3] { { 1,2,3 },{ 4,5,6 } };
    // 构造函数
    public TestTWoDimAttary(){  }
}
  • lua中 需要通过GetLength(维度)来获取长度
  • lua中通过GetValue获取二维数组中的值
  • lua中通过SetValue设置/修改二维数组中的值

lua代码如下

lua 复制代码
local obj = CS.TestTWoDimAttary()

-- 获取二维数组的长度
print("行的长度:" .. obj.array:GetLength(0))
print("列的长度:" .. obj.array:GetLength(1))

-- 获取值
print("通过getValue的方式获取值:" .. obj.array:GetValue(0,0))
print("通过getValue的方式获取值:" .. obj.array:GetValue(1,0))

--lua遍历c#中的数组
for i = 0,obj.array: GetLength(0) - 1 do
	for j = 0,obj.array:GetLength(1) -1  do
		print(obj.array: GetValue(i,j))
	end
end

9.lua中的nil和c#中的null比较

在lua和C#的对象映射中,C#中对空的判断是null而自lua中对空的判断是nil

两者都是空,但是并不代表可以使用.

例如: 检测GameObject上是否有个组件, 没有该组件,就添加组件,使用C#中的Equal()方法进行判断

lua 复制代码
-- 别名
GameObject = CS.UnityEngine.GameObject
Rigidbody = CS.UnityEngine.Rigidbody
BoxCollider = CS.UnityEngine.BoxCollider

-- 
local obj = GameObject("添加刚体的物体")
-- 判断实例化的物体上是否有刚体组件
local rig = obj: GetComponent(typeof(Rigidbody))
-- 注意 需要使用Equals(nil)来判断,
if rig:Equals(nil) then
    rig = obj: AddComponent(typeof(Rigidbody))
end

由于lua中的某对象很有可能就是nil值,因此,我们可以在lua中进行优化,提供判断是否空的兼容性,即在开头添加以下函数进行判断. 当然这种工具列的函数,非常建议卸载一个文件中,然后使用require的方式引用该文件,在需要判断是否为空的地方调用即可

lua 复制代码
--方法2: 使用写全局函数nil和Equals(nil)进行判断

function IsNull(obj)
	if obj == nil or obj:Equals(nil) then
		return true
	end
	return false
end

除了上面的方法,我们还可以在C#中进行做处理,代码如下,以下代码是给了Unity中的GameObject添加了拓展方法,并使用了[LuaCallCSharp]进行标记,表示lua调用C#中的代码. 需要再Unity编辑器中重新使用XLua生成代码

csharp 复制代码
// 扩展方法
[LuaCallCSharp]
public static class class9
{
    public static bool IsNull(this UnityEngine.Object obj)
    {
        return obj == null;    
    }
}

10.lua调用C#中的系统函数

除了能够调用Unity中的系统函数,我们也需要调用C#中的系统函数,我们的一般做法是给代码添加特性[LuaCallCSharp]或者[CSharpCallLua],然而,.Net提供的代码我们无法添加特性,结合扩展的思想,我们可以将我们需要的内容放在一个自定义类中,对自定义类进行扩展即可.

以下代码定义了一个名为 TestSystem 的公共静态类,其中包含两个静态列表:CSharpCallLuaListLuaCallCSharpList。这两个列表用于在不同的编程环境(C# 和 Lua)之间进行类型交互。该静态类的设计允许我们在 C# 和 Lua 之间轻松地传递和操作数据,特别是在使用 Lua 脚本进行游戏开发时。通过这种方式,开发者可以在 C# 中编写核心逻辑,同时利用 Lua 的灵活性和易于修改的特性来快速迭代游戏设计。

当然,你可以自定名称,放在指定的文件夹中

csharp 复制代码
public static class TestSystem
{
    [CSharpCallLua]
    public static List<Type> CSharpCallLuaList = new List<Type>()
    {
        // 需要什么特性就添加什么特性
        typeof(UnityAction<float>),
        typeof(UnityAction<int>),
        typeof(UnityAction<double>)
    };

    [LuaCallCSharp]
    public static List<Type> LuaCallCSharpList = new List<Type>()
    {
        // 需要什么特性就添加什么特性
        typeof(GameObject),
        typeof(Transform),
        typeof(Image)

    };
}

在Unity的场景中创建一个Slider,

我们想通过lua得到当前Slider的值,在C#中是通过AddListener()的方式进行监听,由于是系统AddListener是系统提供的函数,无法添加特性,因此,我们可以使用上面的扩展类进行或者,通过在List中添加即可. 同时,也需要重新生成代码

lua 复制代码
-- 别名
GameObject = CS.UnityEngine.GameObject
UI = CS.UnityEngine.UI

-- 查找Slider的GameObject
local slider = GameObject.Find("Slider")

print(slider)
-- 获取slider上的脚本slider
local sliderScript = slider:GetComponent(typeof(UI.Slider))
-- 绑定slider上的value的值变化情况
sliderScript.onValueChanged:AddListener(function (sliderValue)
	print("slider's Value: " .. sliderValue)
end)

11.lua调用C#中的协程

lua无法直接开启Unity中的协程,需要使用XLua中提供更多工具类,将lua的协程函数进行转换,然后再调用

工具类如下require("xlua.util")

具体流程如下:

  1. 准备好了协程函数和工具与类
  2. 使用工具转换协程函数,并使用lua的开启协程
  3. 保存协程
  4. 在需要的时候关闭协程

在lua中的代码如下:

lua 复制代码
-- 引入工具
util = require("xlua.util")

-- 别名
GameObject = CS.UnityEngine.GameObject
WaitForSeconds = CS.UnityEngine.WaitForSeconds

-- 创建新的物体
local obj = GameObject("Coroutine")
-- 添加脚本
local mono = obj:AddComponent(typeof(CS.LuaCallCSharp))

-- 希望被开启的协程函数
fun = function ()
	local a = 1
	while true do
		-- 使用lua中的协程返回
		coroutine.yield(WaitForSeconds(1))
        
		print("当前a的值:" .. a)
		a = a + 1
		
		if a > 10 then
            -- 关闭协程,和C#中的一样
			mono:StopCoroutine(cor)
		end
	end
end

-- 准备好了协程函数和工具与类
-- 使用工具转换协程函数,并使用lua的开启协程
-- 保存协程
cor = mono:StartCoroutine(util.cs_generator(fun))

12.lua调用C#中的泛型

由于lua中没有泛型,只能通过typeof获得类型. 因此,在使用泛型的方向上,我们可以使用typeof来解决无法直接使用泛型的问题

代码解释:

除了常见的值类型的泛型,int,short,long,float,double,bool,string,enum等,还有我们之定义的类和接口,这些都可以作为泛型,因此,在C#中是可以制动推到的,且在匿名函数中能够字节表现出来. 但是在lua中缺有以下限制. lua中他默认支持有参数,有约束的泛型. 其他条件的就会被限制,毕竟lua是轻量级的脚本语言

以下是C#中各种泛型的代码.

csharp 复制代码
public class TestT
{
    // 内部类和接口
    public interface ITest { }
    public class TestFather : ITest { }
    public class TestChild : TestFather,ITest { }
    // 普通函数
    public void Test()
    {
        Debug.Log("普通测试函数");
    }
	// 有参数,有约束
    public void TestFun1<T>(T a,T b) where T : TestFather
    {
        Debug.Log("有参数,有约束的泛型方法");
    }
	// 有参数,无约束
    public void TestFun2<T>(T a)
    {
        Debug.Log("有参数,没有约束的泛型方法");
    }
	// 无参数,有约束
    public void TestFun3<T>() where T: TestFather
    {
        Debug.Log("无参数,有约束的泛型方法");
    }
	// 有参数,有约束是接口
    public void TestFun4<T>(T a) where T : ITest
    {
        Debug.Log("有参数,有约束,但是约束是接口");
    }
}

以下是lua中的测试代码

lua 复制代码
-- 实例化对象
local obj = CS.TestT()

-- 实例化对象
local father = CS.TestT.TestFather()
local child = CS.TestT.TestChild()

-- 普通函数
print("test")
obj:Test()
-- 有参数,有约束的泛型方法调用
obj: TestFun1(child,father)
obj: TestFun1(father,child)
-- 可以被打印出来

-- 有参数,没有约束的泛型方法
-- lua中不支持有参数没有约束的泛型
-- obj: TestFun2(child)

-- 无参数,有约束的泛型方法
-- obj: TestFun3()
-- lua中不支持无参数有约束的泛型

-- 有参数,有约束,约束是接口
-- lua中不支持约束是接口的泛型
-- obj: TestFun4()

在上面的代码中,有很多代码的调用是被注释,这是由于lua无法直接调用这些代码

因此,为了解决上面的问题,我们需要通过xlua工具进行转换,然后才可以通过调用.

同时,如果使用xlua的工作转换了,打包的时候就只能通过Mono的方式进行打包,如果使用il2cpp的方式,泛型使只能是引用类型,如果值值类型的话,除非C#那边已经调用过了 同类型的泛型参数,lua中才能被使用
否者 lua中无法使用

以下代码是xLua工具转换了的泛型,使用 xlua.get_generic_method(类名,函数名)进行转换

lua 复制代码
-- 转换填写参数: 类名,带有泛型的方法名
local testFun2 = xlua.get_generic_method(CS.TestT,"TestFun2")
-- 确定泛型的类型
local testFun2_Reall = testFun2(CS.System.Int32)
-- 转换完毕后调用
-- 调用
-- 如果是成员方法,第一个参数是 使用函数的对象
-- 如果是静态方法,不用传使用函数的对象
testFun2_Reall(obj,11)
相关推荐
向宇it15 小时前
【unity小技巧】unity 什么是反射?反射的作用?反射的使用场景?反射的缺点?常用的反射操作?反射常见示例
开发语言·游戏·unity·c#·游戏引擎
Heaphaestus,RC16 小时前
【Unity3D】获取 GameObject 的完整层级结构
unity·c#
芋芋qwq16 小时前
Unity UI射线检测 道具拖拽
ui·unity·游戏引擎
tealcwu17 小时前
【Unity服务】关于Unity LevelPlay的基本情况
unity·游戏引擎
大眼睛姑娘19 小时前
Unity3d场景童话梦幻卡通Q版城镇建筑植物山石3D模型游戏美术素材
unity·游戏美术
鹿野素材屋1 天前
Unity Dots下的动画合批工具:GPU ECS Animation Baker
unity·游戏引擎
小春熙子1 天前
Unity图形学之着色器之间传递参数
unity·游戏引擎·技术美术·着色器
Java Fans2 天前
在Unity中实现电梯升降功能的完整指南
unity·游戏引擎
GrimRaider2 天前
[Unity]TileMap开发,TileMap地图缝隙问题
unity·游戏引擎·tilemap
无敌最俊朗@2 天前
unity3d——基础篇小项目(开始界面)
unity·游戏引擎