cocos2d-x Android原生平台与Lua交互

版本： cocos2d-x

语言： C++/Java/Lua

简介

---

cocos2d-x原生平台Android 接入第三方SDK, 需要了解LuaJavaBridge的使用。

它封装了用于Java和Lua的相互调用, 其调用通过C++为中介，简要的流程：

Lua调用Java: Lua -> C++ -> Java

Java调用Lua: Java -> C++ -> Lua

以此方式来实现数据的交互， 接下来我们分别说下这两块东西。

Lua调用Java

---

lua的接口文件主要在 cocos/cocos2d目录下，主要的文件是：

• luaj.lua Lua调用Android平台的接口文件
• luaoc.lua Lua调用苹果平台的接口文件

调用原生平台，使用的方法名均为： callStaticMethod

---------------- luaj.lua ----------------
-- 用于对参数转换为Java的类型简写
local function checkArguments(args, sig)if type(args) ~= "table" then args = {} endif sig then return args, sig end-- Java支持Lua的几种参数类型number,boolean,string, function-- 如果不存在，则按照如下程序进行转换sig = {"("}for i, v in ipairs(args) dolocal t = type(v)if t == "number" thensig[#sig + 1] = "F"elseif t == "boolean" thensig[#sig + 1] = "Z"elseif t == "function" thensig[#sig + 1] = "I"elsesig[#sig + 1] = "Ljava/lang/String;"endendsig[#sig + 1] = ")V"return args, table.concat(sig)
end--[[
@function: 调用java的接口，注意在使用的时候一定要判定是否为为Android平台
@param: className Java完整的类名
@param: methodName Java类方法名
@param: args lua传入的参数，要为table类型，否则会被转换{}
@param: sig 类型简写名，格式为：(参数简写)返回类型简写
]]
function luaj.callStaticMethod(className, methodName, args, sig)-- 检测参数args并将其转换为类型简写local args, sig = checkArguments(args, sig)return callJavaStaticMethod(className, methodName, args, sig)end
endreturn luaj

使用Lua调用Java需要注意：

• Java的方法一定要设置为static类型
• 一定要判定平台的类型，比如Android，IOS，Mac等
• 一定要根据考虑不同版本对原生平台方法的支持，这个主要是防止后续增加的功能，前期版本调用错误
• Lua的callStaticMethod 注意第三个传入参数，一定要为table表数据，避免错误

在Lua项目中，针对于平台的判定相关

-- 示例1
local targetPlatform = cc.Application:getInstance():getTargetPlatform()
if (cc.PLATFORM_OS_ANDROID == targetPlatform) then-- do something
end 
-- 示例2
if device.platform == "android" then-- do something
end

checkArguments

它主要用于将Lua的参数转换为Java的类型简写，以用于获取数据，如下Java支持的Lua类型简写

Lua类型	简写格式	说明
number	F	浮点类型
boolean	Z	布尔类型
function	I	整数或方法
string	Ljava/lang/String;	字符串
	V	用于java方法中无返回值

这个是跟C++调用Java是类似的，但Lua没有那么多的数据类型支持，比如C++中的char, shot, long, double等。

类型简写的格式大致为： (参数类型简写)返回类型简写，简单的实例：

Java方法	简写	说明
void showText()	“()V”	无参数，无返回
int getWifiLevel()	“()I”	无参数，返回整型
String getSystemVersion()	“()Ljava/lang/String;”	无参数，返回字符串
int addNumber(final int num1, final int num2)	“(II)I”	参数两个整型，返回整型
boolean isGetPhoneData(final String name, final int Count)	“(Ljava/lang/String;I)Z”	参数分别为字符串，整型，返回布尔类型

在checkArguments中存在关于类型简写的转换，但是建议了解下，以备突发情况使用。

callStaticMethod

它是Lua调用调用C++的中介接口，用于将参数相关通过C++传递给Java。它的主要实现在：

// ../frameworks/cocos2d-x/cocos/scripting/lua-bindings/manual/platform/android目录下
// CCLuaJavaBridge.cpp
void LuaJavaBridge::luaopen_luaj(lua_State *L)
{s_luaState = L;lua_newtable(L);lua_pushstring(L, "callStaticMethod");lua_pushcfunction(L, LuaJavaBridge::callJavaStaticMethod);lua_rawset(L, -3);lua_setglobal(L, "LuaJavaBridge");
}

该接口在Lua中调用后主要会有两个返回值，分别是：

• 成功标记，布尔类型；
• 错误编码，整数类型

如果成功，则错误编码为0，否则就是其他数值，主要的错误码有：

// CCLuaBridget.h
typedef enum {// 成功kLuaBridgeErrorOk                   = 0, // 无效的参数kLuaBridgeErrorInvalidParameters    = -1,// 类没有找到kLuaBridgeErrorClassNotFound        = -2,// 方法没有找到kLuaBridgeErrorMethodNotFound       = -3,// 执行异常kLuaBridgeErrorExceptionOccurred    = -4,// 错误的类型简写kLuaBridgeErrorMethodSignature      = -5,// 虚拟机错误kLuaBridgeErrorJavaVMError          = -6,
} LuaBridgeError;

这个错误类型与luaoc.lua的检测类型参数是相似的。官方实例：

• Lua相关

-- LuaBridgeTest.lua 示例仅摘抄了其主体代码
function newLuaJavaBridge()local targetPlatform = cc.Application:getInstance():getTargetPlatform()if (cc.PLATFORM_OS_ANDROID ~= targetPlatform) thenreturn end -- 引用库文件local luaj = require "cocos.cocos2d.luaj"-- Java类名local className = "com/cocos2dx/sample/LuaJavaBridgeTest/LuaJavaBridgeTest"-- Java方法名local methodName = "addTwoNumbers"  -- 参数local args = {2, 3}-- 类型简写local sigs = "(II)I"-- 调用方式一: 传入两个参数获取数值local success, result = luaj.callStaticMethod(className, methodName, args, sigs)if not success thenprint("luaj error:", result)elseprint("The result is:", result)end-- 调用方式二: 传入两个参数获取结果通过Lua的回调显示日志local function callbackLua(param)if "success" == param thenprint("java call back success")endendargs = { "callbacklua", callbackLua }sigs = "(Ljava/lang/String;I)V"ok = luaj.callStaticMethod(className,"callbackLua",args,sigs)if not ok thenprint("call callback error")end
end

• Java相关

package com.cocos2dx.sample.LuaJavaBridgeTest;// 用于java调用Lua
import org.cocos2dx.lib.Cocos2dxLuaJavaBridge;public class LuaJavaBridgeTest
{    // Lua调用javapublic static int addTwoNumbers(final int num1,final int num2){return num1 + num2;}// Java调用Luapublic static void callbackLua(final String tipInfo,final int luaFunc){// 调用局部Lua-Function，将luaFunc结果发送给LuaCocos2dxLuaJavaBridge.callLuaFunctionWithString(luaFunc, "success");Cocos2dxLuaJavaBridge.releaseLuaFunction(luaFunc);}
}

至此，Lua调用Java告一段落。

Java调用Lua

Java是允许调用Lua的，同Java调用C++一样。主要的接口是：

// 调用局部Lua-Function
public static native int callLuaFunctionWithString(int luaFunctionId, String value); 
// 调用全局Lua-Function
public static native int callLuaGlobalFunctionWithString(String luaFunctionName, String value); 
// retain一次Lua-Function
public static native int retainLuaFunction(int luaFunctionId); 
// release掉Lua-Function
public static native int releaseLuaFunction(int luaFunctionId); 

后续补充…