跳到主要内容

C# 调用 Lua

用 LuaAppDomain.GetFunction<T> 按模块名与方法名取得绑定好的 Delegate，再调用。Editor 与 Player API 相同。

Canonical：Bootstrap.cs

基本用法​

var main = LuaAppDomain.GetFunction<Action>("app", "main");
main();

var add = LuaAppDomain.GetFunction<Func<int, int, int>>("app", "add");
int sum = add(10, 20);
local function add(a, b)
    return a + b
end

return {
    main = main,
    add = add,
}
规则说明
先 Initialize否则抛异常
T : MulticastDelegate具体 Action / Func / 自定义委托
module / method"app","add" ↔ return { add = ... }
缓存热路径自行保存；不保证同实例
时机须在 Initialize 之后；勿放在与 RuntimeInitializeOnLoadMethod 同类型的 static 字段初始化器

模块加载​

GetFunction("app", …) 要求 LoadLuaModule("app") 能返回源码。

环境典型路径
Editor{ProjectRoot}/LuaScripts/app.lua
PlayerStreamingAssets/LuaScripts/app.lua.txt
private static string LoadLuaModule(string module)
{
#if UNITY_EDITOR
    string path = Path.Combine(Application.dataPath, "..", "LuaScripts", module + ".lua");
#else
    string path = Path.Combine(
        Application.streamingAssetsPath, "LuaScripts", module + ".lua.txt");
#endif
    return File.Exists(path) ? File.ReadAllText(path, Encoding.UTF8) : null;
}

要点：

  • 模块须 return { key = fn }；键名 = GetFunction 的 method
  • 子路径：module.Replace('.', '/')（如 battle.ai）
  • Player 构建前 Sync，见 构建流程
  • 热更 / 清空脚本世界用 LuaAppDomain.Reset(loader)（EndOfFrame 生效；旧 GetFunction 委托作废，须重新绑定）；不再支持对已初始化域「只换 loader」。Android 上 StreamingAssets 只读需注意

多模块​

var appMain = LuaAppDomain.GetFunction<Action>("app", "main");
var battleTick = LuaAppDomain.GetFunction<Action<float>>("battle", "tick");

与「形参里的 function」对照​

场景做法
C# 主动调某个 Lua 导出函数GetFunction<T>(module, method)
C# 形参是 Action/Func，Lua 传入 function隐式 marshal，见 Function
Lua 侧已有 function，要指定委托类型zlua.to_delegate

常见错误​

现象处理
module 'app' not foundEditor/Player 路径；是否 Sync
GetFunction 结果无效 / 调用无效果未 Initialize；return 表键名不一致
旧脚本仍在跑Player 未重新 Sync

学习路径​

上一篇Lua 调用 C#
下一篇值类型

相关文档​