五邑隐侠,本名关健昌,12年游戏生涯。 本教程以 Unity 3D + VS Code + C# + tolua 为例。
一、启动脚本
第一篇 “搭建开发环境”,在 “配置 Lua 开发环境” 一节提到,把 tolua 下的 Assets、Luajit、Luajit64、Unity5.x拷贝到工程根目录,简化 C#、Lua 互调。
先打开 Assets/Lua/Main.lua ,加上 OnUpdate() 方法(第6~8行)
- 1 --主入口函数。从这里开始lua逻辑
- 2 function Main()
- 3 print("logic start")
- 4 end
- 5
- 6 function OnUpdate()
- 7 print("Lua OnUpdate")
- 8 end
- 9
- 10 --场景切换通知
- 11 function OnLevelWasLoaded(level)
- 12 collectgarbage("collect")
- 13 Time.timeSinceLevelLoad = 0
- 14 end
- 15
- 16 function OnApplicationQuit()
- 17 end
新建目录CSharp用于存放C#脚本,新建一个C#脚本 Main.cs 作为启动脚本
- 1 using UnityEngine;
- 2 using LuaInterface;
- 3
- 4 public class Main : LuaClient
- 5 {
- 6 private LuaFunction updateFun = null;
- 7
- 8 // Start is called before the first frame update
- 9 void Start()
- 10 {
- 11 // bind OnUpdate
- 12 this.updateFun = luaState.GetFunction("OnUpdate");
- 13 }
- 14
- 15 new void OnApplicationQuit()
- 16 {
- 17 this.updateFun.Dispose();
- 18 this.updateFun = null;
- 19
- 20 base.OnApplicationQuit();
- 21 }
- 22
- 23 // Update is called once per frame
- 24 void Update()
- 25 {
- 26 this.updateFun.Call();
- 27 }
- 28 }
1、在Unity里,场景由GameObject组成。加载场景,会创建场景中的GameObject。
2、GameObject可以添加组件,组件基类为Component,但用户自定义的脚本都继承自MonoBehaviour(Component的子类)
3、Main类继承 LuaClient,LuaClient 继承 MonoBehaviour,所以 Main.cs 脚本可以作为组件添加到场景的 GameObject上。
4、组件有几个关键的生命周期:
1)Awake:只调用一次,在组件整个生命周期开始时调用,组件一般不建议写构造方法,需要提前初始的数据,可以在Awake初始化
2)Start:第一次Enable时调用,整个生命周期只调用一次,可以在这里初始化组件数据
3)Update:每帧调用一次
4)OnApplicationQuit:游戏退出时调用
5、LuaClient 在 Awake 里 初始化 Lua 环境,绑定C#类到Lua,然后加载 Assets/Lua/Main.lua 文件,并调用其中的 function Main() 方法,开始 Lua 逻辑。
6、luaState 是 LuaClient 的一个LuaState类型字段,保存 Lua 虚拟机对象。LuaState.GetFunction 获取 Lua一个返回LuaFunction类型的全局方法。第12行获取Lua 的 OnUpdate 方法,该方法在 Assets/Lua/Main.lua 里定义
7、LuaFunction.Call() 执行该Lua方法。第26行,组件Main每次 Update 时都 调用 Assets/Lua/Main.lua 的 OnUpdate 方法,驱动 Lua 逻辑更新。
二、Unity3D编辑器简介
1、层级管理面板
显示场景中所有的 GameObject,可以快速选中场景中的 GameObject

2、场景编辑面板
可视化编辑场景中GameObject位置

3、预览面板
预览场景运行的效果

4、属性面板
展示 GameObject 添加的组件,以及组件的属性。如图中选中 Main Camera 后显示该GameObject 的组件有Transform、Camera组件

5、工程面板
工程的资源仓库(脚本也是资源),用于搭建场景的零部件:脚本、声音、图片、预制体、场景等

三、添加启动脚本到场景
1、在工程面板选择Scenes文件夹,默认3D工程会生成一个SampleScene,如果没有,可以手动创建一个。双击这个场景图标,会打开该场景

2、在层级管理面板选择 Main Camera 这个 GameObject

3、在属性面板下方,点击 Add Component 按钮,选择 Scripts --> Main,这样场景运行时,Main脚本就会开始它的生命周期

4、作为启动脚本,我们希望它比其他脚本优先执行。在工程面板选择CSharp文件夹,选中Main脚本

5、在属性面板右上方,点击 Execution Order 按钮

6、添加Main脚本,并调整其顺序在 Default Time 之前
