Unity开发者联盟收藏本站
发帖教程新人必读切换到宽版

 找回密码
 立即注册
Unity开发者联盟»论坛 › 3D Dev Asset 开发资源大全 › 学术研究 Scholarly › xLua热更新
返回列表 发新帖
查看: 302|回复: 0

xLua热更新

[复制链接]
发表于 2021-8-13 08:47 | 显示全部楼层 |阅读模式
1、作者教程：http://www.gad.qq.com/article/detail/24967
2、GitHub地址：https://github.com/Tencent/xLua       下载之后只需要把Plugins、XLua两个文件夹导入到Unity3D的Assets目录下就可以了。可以按照XLua文件夹下的XLua教程进行学习（如下图）
[img][/img]

[img][/img]



001-利用XLua在控制台输出Hello world
  1. /*
  2. *Title:"XLua学习"项目开发
  3. */
  5. using System.Collections;
  6. using System.Collections.Generic;
  7. using UnityEngine;
  8. using XLua;                                //引入xLua命名空间
  9. public class HelloWorld : MonoBehaviour {
  10.     private LuaEnv _luaenv;                //推荐全局唯一
  11.     void Start () {
  12.         _luaenv = new LuaEnv();                //Lua运行环境
  14.         //_luaenv.DoString("print('Hello world')");                        //执行字符串形式的Lua代码
  15.         _luaenv.DoString("CS.UnityEngine.Debug.Log('Hello world')");        //调用C#的Api
  16.     }
  17.        
  18.     private void OnDestroy()
  19.     {
  20.         _luaenv.Dispose();                //释放lua运行环境
  21.     }
  22. }
复制代码
002-读取Lua文件的代码并运行在Resources文件夹下新建一个Lua文件。如：HelloWorld.lua.txt（由于用Resources.Load<AssetText>()加载的是.txt类型的文件）
  1. /*
  2. *Title:"XLua学习"项目开发
  3. *
  4. *Description:
  5. *        用于场景002
  6. *   读取Lua文件来执行Lua代码
  7. *Date:2017
  8. *
  9. *Version:0.1
  10. *
  11. *Modify Recoder:
  12. */
  14. using System.Collections;
  15. using System.Collections.Generic;
  16. using UnityEngine;
  17. using XLua;
  18. public class HelloWorldByFile : MonoBehaviour {
  19.     LuaEnv _luaEnv;
  20.         // Use this for initialization
  21.         void Start () {
  22.         _luaEnv = new LuaEnv();
  23.         //方法1
  24.         //TextAsset ta =  Resources.Load<TextAsset>("HelloWorld.lua");//后缀自动添加.txt，因为是TextAsset类型
  25.         //_luaEnv.DoString(ta.text); //读取文本的字符串并运行
  27.         //方法2 用xLua自带的Loader加载和执行
  28.         _luaEnv.DoString("require 'HelloWorld'"); //HelloWorld相当于HelloWorld.lua.txt，XLua的Loader会自动在Resources目录下加载
  29.     }
  30.     void OnDestroy()
  31.     {
  32.         _luaEnv.Dispose();
  33.     }
  34. }
复制代码
003-自定义Loader，读取其他目录下的Lua文件
  1. /*
  2. *Title:"XLua学习"项目开发
  3. *
  4. *Description:
  5. *        自定义Loader（加载器）
  6. *
  7. *Date:2017
  8. *
  9. *Version:0.1
  10. *
  11. *Modify Recoder:
  12. */
  14. using System.Collections;
  15. using System.Collections.Generic;
  16. using UnityEngine;
  17. using XLua;
  18. using System.IO;
  20. public class DefineLoader : MonoBehaviour {
  21.     private LuaEnv _luaEnv;
  22.         // Use this for initialization
  23.         void Start () {
  24.         _luaEnv = new LuaEnv();
  25.         _luaEnv.AddLoader(MyLoader); //增加一个Loader
  26.         _luaEnv.DoString("require 'DefineLoaderTest'");
  27.     }
  28.        
  29.     //通过require加载一个文件的时候，会访问每一个Loader（先访问自定义的Loader后内置Loader）直到返回的不为空
  30.     private byte[] MyLoader(ref string filePath)
  31.     {
  32.         Debug.Log(filePath);            //这里filePath为DefineLoaderTest
  33.         string absPath = Application.streamingAssetsPath + "/" + filePath + ".lua.txt"; //获取文件所在目录
  34.         //把lua文件里面的字符串转换成字节数组返回,lua文件如果有中文需要把编码改为UTF8
  35.         return System.Text.Encoding.UTF8.GetBytes(File.ReadAllText(absPath));      
  36.     }
  38.     void OnDestroy()
  39.     {
  40.         _luaEnv.Dispose();
  41.     }
  42. }
复制代码
004-通过C#调用Lua里面的全局变量、表（方法、变量）CSharpCallLua(lua代码)：
  1. intA = 100
  2. floB = 0.52
  3. isRun = true
  4. strName = 'Happy'
  7. person = {
  8. name = 'Jackey',age = 20,3,4.5,true,"stringgg",
  9. eat = function(self,foodName) --self代表当前对象,比C#对应的对象多一个参数
  10.   print("正在吃："..foodName)
  11. end
  12. }
  15. --[其他方式
  16. function person:eat(foodName) --用:的方式，会自动添加self
  17. print("正在吃："..foodName)
  18. end
  21. function person.eat(self,foodName) --用.的方式，要自行添加
  22. print("正在吃："..foodName)
  23. end
  24. --]
  27. function add(a,b) --全局函数
  28. print(a+b)
  29. return a+b,a,b
  30. end
复制代码
C#代码：
  1. /*
  2. *Title:"XLua学习"项目开发
  3. *
  4. *Description:
  5. *        C#访问Lua里面的全局变量
  6. *
  7. *Date:2017
  8. *
  9. *Version:0.1
  10. *
  11. *Modify Recoder:
  12. */
  15. using System.Collections;
  16. using System.Collections.Generic;
  17. using UnityEngine;
  18. using XLua;
  19. using System;
  20. public class CSharpCallLua : MonoBehaviour {
  21.     private LuaEnv _env;
  22.         // Use this for initialization
  23.         void Start () {
  24.         _env = new LuaEnv();
  25.         _env.DoString("require 'CSharpCallLua'");               //加载并执行lua文件
  28.         /*获取基本变量*/
  29.         int intA = _env.Global.Get<int>("intA");                //获取Lua里面Int类型的全局变量
  30.         Debug.Log(intA);
  31.         float floB = _env.Global.Get<float>("floB");            //获取Lua里面float类型的全局变量
  32.         Debug.Log(floB);
  33.         bool isRun = _env.Global.Get<bool>("isRun");            //获取Lua里面bool类型的全局变量
  34.         Debug.Log(isRun);
  35.         string strName = _env.Global.Get<string>("strName");    //获取Lua里面string类型的全局变量
  36.         Debug.Log(strName);
  39.         /*获取table的方式一，通过类Class（Struct）*/
  40.         Person p = _env.Global.Get<Person>("person"); //值拷贝，C#修改数据并不会同步到Lua，Lua修改也不影响C#
  41.         Debug.Log(p.name);
  42.         Debug.Log(p.age);
  45.         /*获取table的方式二，通过接口interface（推荐）*/
  46.         IPerson ip = _env.Global.Get<IPerson>("person"); //传引用，在C#修改会影响Lua里面的变量
  47.         Debug.Log(ip.name);
  48.         Debug.Log(ip.age);
  49.         ip.eat("鸡腿"); //相当于ip.eat(ip,"鸡腿");
  52.         /*获取table的方式三，通过键值对Dictionary、集合List（推荐）*/
  53.         //Dictionary--只能映射table里面有键的元素
  54.         Dictionary<string, object> dict = _env.Global.Get<Dictionary<string, object>>("person");
  55.         foreach (string key in dict.Keys)
  56.         {
  57.             Debug.Log(key + '-' + dict[key]);
  58.         }
  59.         //List--只能映射table里面没有键的元素
  60.         List<object> list = _env.Global.Get<List<object>>("person");
  61.         foreach (object item in list)
  62.         {
  63.             Debug.Log(item);
  64.         }
  67.         /*通过LuaTable类（不推荐，性能比较差）*/
  68.         LuaTable tab = _env.Global.Get<LuaTable>("person");
  69.         print(tab.Get<string>("name"));
  70.         print(tab.Get<int>("age"));
  71.         print(tab.Length);
  76.         /*访问Lua中的全局函数*/
  77.         //方法一：映射到delegate
  78.         Add act1 = _env.Global.Get<Add>("add");//属于命名空间System
  79.         int resa, resb;
  80.         print(act1(1,2,out resa,out resb));
  81.         print(resa);
  82.         print(resb);
  85.         //方法二：映射到LuaFunction (不推荐)
  86.         LuaFunction lf = _env.Global.Get<LuaFunction>("add");
  87.         object[] os = lf.Call(3, 4);
  88.         foreach (object item in os)
  89.         {
  90.             print(item);
  91.         }
  94.     }
  95.     class Person
  96.     {
  97.         public string name;
  98.         public int age;
  99.     }
  102.     [CSharpCallLua] //会为接口增加一些映射使用的代码
  103.     interface IPerson
  104.     {
  105.         string name { get; set; }  //必须添加get set属性
  106.         int age { get; set; }
  107.         void eat(string foodName);
  108.     }
  109.     [CSharpCallLua]
  110.     delegate int Add(int a, int b,out int resa,out int reab); //lua全剧函数里面的第一个返回值会给C#的返回值，第二个返回值会给第一个out，第三个返回值会给第二个out
  111.     void OnDestroy()
  112.     {
  113.         _env.Dispose();
  114.     }
  115. }
复制代码
005-通过lua代码访问C#
LuaCallCSharp(lua代码)：
  1. CS.UnityEngine.GameObject("new by lua")                                --创建游戏物体（new对象）
  3. print(CS.UnityEngine.Time.deltaTime)                                --访问C#静态属性
  5. CS.UnityEngine.Time.timeScale = 0.5                                        --设置C#中的属性
  7. local camera = CS.UnityEngine.GameObject.Find('Main Camera')        --用局部变量保存C#中的对象
  9. camera.name = "update by lua"                                                --修改对象名称
  11. local gameObject = CS.UnityEngine.GameObject                --用局部变量进行引用，可以节省性能，以及减少编码量
  12. local light = gameObject.Find('Directional Light')
  13. light.name = 'new light name'
  15. local cameraCam = camera:GetComponent('Camera')    --获取Camera上的组件。推荐使用冒号调用成员函数，如果用点的话，第一个参数需要是当前对象        
  16. gameObject.Destroy(cameraCam)                      --移除这个组件
复制代码
C#代码：
  1. /*
  2. *Title:"XLua学习"项目开发
  3. *
  4. *Description:
  5. *        在lua里访问C#
  6. *
  7. *Date:2017
  8. *
  9. *Version:0.1
  10. *
  11. *Modify Recoder:
  12. */
  14. using System.Collections;
  15. using System.Collections.Generic;
  16. using UnityEngine;
  17. using XLua;
  19. public class LuaCallCSharp : MonoBehaviour {
  21.     private LuaEnv _env;
  22.     // Use this for initialization
  23.     void Start()
  24.     {
  25.         _env = new LuaEnv();
  26.         _env.DoString("require 'LuaCallCSharp'");               //加载并执行lua文件
  27.     }
  29.     void OnDestroy()
  30.     {
  31.         _env.Dispose();
  32.     }
  33. }
复制代码
006-lua和C#中参数的对应（ref、out等关键字） Lua调用侧的参数处理规则：C#普通参数算一个输入形参，ref修饰的算一个输入形参，out不算，然后从左往右对应lua调用侧的实参列表。
Lua调用侧的返回值处理规则：C#函数的返回值（如果有的话）算一个返回值，out 算一个返回值，ref算一个返回值，然后从左往右对应lua的多返回值。
007-特性[LuaCallCSharp]和[CSharpCallLua]
在Lua获取或者调用C#的时候用[LuaCallCSharp]

在C#获取或者调用Lua的时候用[CSharpCallLua]
在枚举，委托，接口等前面加上[CSharpCallLua]或者[LuaCallCSharp]
008-lua中相当于C#中+=或-=的事件注册
例如testobj里有一个事件：public event Action TestEvent；
增加事件回调：testobj:TestEvent('+',lua_evnet_callback)
移除事件回调：testobj:TestEvent('-',lua_event_callback)

热更新大致流程

更新的东西有两部分：1、资源（Assetbundle） 2、lua代码    这两样东西放在服务器端，客户端连接服务器检查（MD5校验）是否有更新。服务器端使用一个文本文件存放所有Assetbundle和Lua的文件列表和对应的MD5值。客户端下载这个文本文件，客户端拿本地资源的MD5值对比服务器的MD5值，如果不一样则进行更新。这是其中一种方法。





本帖子中包含更多资源

您需要 登录 才可以下载或查看，没有账号？立即注册

×
回复

使用道具 举报

返回列表 发新帖
懒得打字嘛，点击右侧快捷回复 【右侧内容，后台自定义】
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

小黑屋|手机版|Unity开发者联盟 ( 粤ICP备20003399号 )

GMT+8, 2024-11-24 08:54 , Processed in 0.091208 second(s), 26 queries .

Powered by Discuz! X3.5 Licensed

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表