Lua接口/服务端/SetCharacterTimer

来自天龙知识库
雪舞留言 | 贡献2026年9月7日 (一) 19:03的版本 (整理当前服务端 Lua 接口:注册名称、参数、返回值与调用说明)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 服务端接口 · 通用与活动 · 调用约定

设置 Character的时钟间隔,如果是0则,停止时钟

Lua 调用

SetCharacterTimer(sceneId, selfId, nTime)

参数

序号 参数 / 类型 说明
1 sceneId
number
当前调用所在的场景 ID。
2 selfId
number
当前场景内的对象 ID。玩家接口需传入有效玩家对象;不是角色 GUID。
3 nTime
number
时间间隔

返回值

无返回值。赋值接收时得到 nil;这与返回数字 0 不同。

用法补充

设置 Character的时钟间隔,如果是0则,停止时钟
每次心跳发生时:如果是玩家,则会运行 Scene.lua里面的OnScenePlayerTimer函数
如果是宠物或者怪物,则会运行所挂脚本的 OnCharacterTimer函数

注意事项

  • 调用对象必须是当前场景中的有效角色对象,可包括玩家、怪物或珍兽。
核对依据:LuaFnTbl_Misc.h 第 2726 行,服务端注册表第 373 行。调用格式与返回数量依据当前实现整理;游戏内效果、边界行为及未注明的业务枚举仍需实测。