Lua接口/服务端/LuaFnGetPetSoulWashGift

来自天龙知识库
跳到导航跳到搜索

首页 · 服务端接口 · 珍兽魂 · 调用约定

查询指定品质的珍兽魂洗练赠送进度与各档可领取次数。

Lua 调用

LuaFnGetPetSoulWashGift(sceneId, selfId, quality)

服务端脚本中共出现 1 处调用，实参个数出现过：3 个（1 处）。

实现位于 LuaFnTbl_PetSoul.h。

参数

序号 参数 / 类型 说明
1 sceneId
number 		当前调用所在的场景 ID。
脚本中的实参：sceneId
2 selfId
number 		当前场景内的对象 ID；必须是本场景线程中的有效玩家，不是角色 GUID。
脚本中的实参：selfId
3 quality
number 		品质档位，取值 1 或 2。
脚本中的实参：quality

返回值

返回 4 个 string：第 1 个是已消耗数量，其后三个是三个档位当前可领取的次数（阈值按品质取 150/750/3000 或 200/1000/4000）。全部是十进制字符串，参与数值比较前要先 tonumber。玩家或品质无效时不返回值。

脚本中的调用

以下是服务端脚本里的真实调用点，按实参形态去重后列出 1 条。这些调用取自随包发布的脚本，可用于确认参数顺序与实际传入的值；它们不代表该写法在当前版本仍然有效。 

-- obj/suzhou/osuzhou_yunshenshen.lua
LuaFnGetPetSoulWashGift(sceneId, selfId, quality)

注意事项

  • 实现体要求实参恰好 3 个（含 sceneId、selfId），多传或少传都直接返回失败值。
  • 返回的是字符串而不是数字，直接参与算术运算会报错。
  • 品质 0 能通过参数校验，但随即被「quality < 1」拒绝，此时返回 0 个值。
检索自“https://www.waylee.net/index.php?title=Lua接口/服务端/LuaFnGetPetSoulWashGift&oldid=12599”