Lua接口/消息与提示

向玩家发送文本消息、操作结果提示与各类界面提示。消息接口多数不返回 Lua 值，不能靠返回值判断是否显示成功。

文本消息

Msg2Player 返回 1 表示已发送、-1 失败，是本组中少数有返回值的接口。DispatchMissionTips、AddNumber、AddRandItemBonus 都无返回值。

接口	参数与返回
SendOResultToPlayer	`sceneId, selfId, resultCode` → 成功不返回 Lua 值，失败 -1。
LuaFnSendOpResult	`sceneId, selfId, resultCode` → 成功不返回 Lua 值，失败 -1。

这两个接口**成功时不返回值**（赋值接收得到 nil），失败才返回 -1，不能用 if result then 判断成功。

接口	参数与返回
LuaFnOpenPWBox	`sceneId, selfId` → 0。二级密码未解锁时打开解锁界面。
OpenWorldReference	`sceneId, selfId, pParam` → 1 / -1。打开江湖指南指定页面。
LuaFnSendGuajiQuestion	`sceneId, selfId` → 返回值；失败 -1。挂机验证码。

接口	参数与返回
LuaFnSendAbilitySuccessMsg	`sceneId, selfId, AbilityId, RecipeId, ItemSerialNum`；无返回值。
LuaFnSendAbilityFailureMsg	`sceneId, selfId, abilityId, recipeId, itemSerial`；无返回值。

生活技能制造的成功 / 失败消息，都无返回值。

接口	参数与返回
PrintNum	`num`；无返回值。弹出消息框（测试脚本用）。
PrintStr	`strText`；无返回值。弹出消息框（测试脚本用）。

PrintNum 与 PrintStr 是**测试脚本用**的弹框，正式脚本不要依赖。

local result = Msg2Player(sceneId, selfId, "message", 0)
if type(result) == "number" and result == 1 then
    -- 消息已发送
end

Msg2Player 需要 4 个参数，返回 1 表示已发送。

SendOResultToPlayer(sceneId, selfId, resultCode)
-- 成功不返回 Lua 值，失败才返回 -1
-- 不能写 if SendOResultToPlayer(...) then 判断成功

SendOResultToPlayer 成功路径不返回值。