#slua Fastest Unity lua binding via static code generating.
QQ group: 15647305 (in chinese)
Support QA: http://www.unityqa.com/ (in chinese)
Mail to : sineysan#163.com (both of chinese/english)
##Release Download
##Help
See inner demo for help or Document (in chinese).
##important
You need generated lua wrap file by your self:
Click menu, SLua->Make ALL generate all wrap file for your version of unity.
Had tested for Unity4.6.1/4.6.2/4.6.3/5.0
##main feature
static code generating, no reflection, no extra gc alloc, very fast
full support iOS/iOS64, support il2cpp
above 90% UnityEngine interface exported ( remove flash, platform dependented interface )
100% UnityEngine.UI interface ( require Unity4.6+ )
support UnityEvent/UnityAction for event callback via lua function
support delegate via lua function (include iOS)
support yield call
support custom class exported
export enum as integer
return array as lua table
using raw luajit, can be replaced with lua5.3/lua5.1, link with slua.c, if you switch to lua5.3, add LUA_5_3 macro in build setting.
##usage
copy Assets/Plugins Assets/Slua to your
click Make, regenerate UnityEngine interface for lua
click Make UI, regenerate UnityEngine.UI interface for lua
click Make custom , generate custom class interface for lua
Clear custom, delete all generated custom interface
Slua/LuaObject contain pre-generated file for exported interface.
Precompiled slua library in Plugins only included x86(32bit)/macosx(32bit)/iOS(armv7,armv7s,arm64)/Android(armv7-a) platform using luajit, you should compile other platform/lua5.1/luajit by yourself, see build.txt for help.
-- import
import "UnityEngine"
function main()
-- create gameobject
local cube = GameObject.CreatePrimitive(UnityEngine.PrimitiveType.Cube)
-- find gameobject
local go = GameObject.Find("Canvas/Button")
-- get component by type name
local btn = go:GetComponent("Button")
-- get out parameter
local hitinfo = RaycastHit()
local ok,hitinfo = Physics.Raycast(Vector3(0,0,0),Vector3(0,0,1),hitinfo)
print("Physics Hitinfo",ok,hitinfo)
-- foreach enumeratable object
for t in Slua.iter(Canvas.transform) do
print("foreach transorm",t)
end
-- add event listener
btn.onClick:AddListener(function()
local go = GameObject.Find("Canvas/Text")
local label = go:GetComponent("Text")
label.text="hello world"
end)
-- use vector3
local pos = Vector3(10,10,10)+Vector3(1,1,1)
cube.transform.position = pos
-- use coroutine
local c=coroutine.create(function()
print "coroutine start"
Yield(WaitForSeconds(2))
print "coroutine WaitForSeconds 2"
local www = WWW("http://www.sineysoft.com")
Yield(www)
print(#Slua.ToString(www.bytes))
end)
coroutine.resume(c)
-- add delegate
Deleg.daction = {"+=",self.actionD} --it's ok for iOS
-- remove delegate
Deleg.daction = {"-=",self.actionD} --it's ok for iOS
-- set delegate
Deleg.daction = function() print("callback") end --it's ok for iOS
-- remove all
Deleg.daction = nil
end
##export custom class
add CustomLuaClass attribute to your custom class, waiting for compile completed, click "Make custom", you will get interface file for lua.
[CustomLuaClass]
public class HelloWorld {
}
###benchmark
see http://www.sineysoft.com/post/164 for detail (in chinese), compared with ulua/raw mono.
with luajit
unit is secend, run 200k times / test, more smarller more better.