计时器接口：MiniTimer
彼得兔
更新时间: 2023-04-26 20:24:50
具体函数名及描述如下:序号 函数名 函数描述
1 isExist(...) 判断计时器是否存在
2 createTimer(...) 添加计时器
3 deleteTimer(...) 删除计时器
4 startBackwardTimer(...) 启动倒计时
5 startForwardTimer(...) 启动正向计时
6 pauseTimer(...) 暂停计时器
7 resumeTimer(...) 恢复计时器
8 stopTimer(...) 停止计时器
9 changeTimerTime(...) 改变计时器计时
10 getTimerTime(...) 获取计时器时间
11 showTimerWnd(...)
显示计时器窗口(若其他计时器已经显示，则替换显示)
12 hideTimerWnd(...)
隐藏计时器窗口13 threadpool:wait() 等待时间多少秒
14 Trigger:wait() 等待时间多少秒
15 threadpool:work(function() 函数体 end)
isExist
参数及类型：id:int
返回值及类型：result:bool
该方法的主要作用：判断计时器是否存在具体使用案例如下：
--判断id为1的计时器是否存在，参数1就是计时器id
local result=MiniTimer:isExist(1)
if result==0 then--如果存在
--在聊天框显示
Chat:sendSystemMsg("id为1的计时器存在！")
--让id为1的计时器开始20秒倒计时
MiniTimer:startBackwardTimer(1,20,false)
--在房主游戏界面显示计时时间
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为：",true)
--在聊天框显示
Chat:sendSystemMsg("开始20秒倒计时！")
else--如果不存在
--在聊天框显示
Chat:sendSystemMsg("id为1的计时器不存在！")
--创建一个计时器，命名为“timer”
local result2,id=MiniTimer:createTimer("timer",nil,true)
--在聊天框显示
Chat:sendSystemMsg("创建了一个名为“timer”的新计时器并开始20秒倒计时！计时器id为"..id)
--让新创建的这个计时器开始20秒倒计时
MiniTimer:startBackwardTimer(id,20,false)
--在房主游戏界面显示计时时间
MiniTimer:showTimerTips({0},id,"id为1的计时器的计时为：",true)
end
Lua
createTimer
参数及类型：name:string
返回值及类型：ErrorCode.OK
id:int计时器索引
该方法的主要作用：添加计时器具体使用案例如下：
--创建一个新计时器，命名为“timer”
--第一个参数就是创建的计时器的名字，第二个参数是地图id(作用不明，默认不传)，第三个参数是是否为存档私有计时器(改为false则所有存档可共用此计时器。默认不传)
local result,id=MiniTimer:createTimer("timer",nil,true)
--在聊天框显示
Chat:sendSystemMsg("新建了名为“timer”的计时器，id为"..id)
Lua
deleteTimer
参数及类型：id:int
返回值及类型：ErrorCode.OK
该方法的主要作用：删除计时器具体使用案例如下：
--删除id为1的计时器。参数为要删除的计时器的id
MiniTimer:deleteTimer(1)
--在聊天框显示
Chat:sendSystemMsg("删除了id为1的计时器！")
Lua
startBackwardTimer
参数及类型：id:int计时器索引
interval:int倒计时间隔时间
repeated:bool是否重复执行
返回值及类型：ErrorCode.OK
该方法的主要作用：启动倒计时具体使用案例如下：
--让id为1的计时器开始20秒倒计时
--第一个参数为计时器id，第二个参数为倒计时时间，第三个参数为是否重复执行(貌似无效)
MiniTimer:startBackwardTimer(1,20,false)
--在聊天框显示
Chat:sendSystemMsg("启动了id为1的计时器，倒计时20秒！")
--在房主游戏界面显示id为1的计时器的计时
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为：",true)
Lua
startForwardTimer
参数及类型：id:int计时器索引
返回值及类型：ErrorCode.OK
该方法的主要作用：启动正向计时具体使用案例如下：
--让id为1的计时器递增计时，参数1就是计时器id
MiniTimer:startForwardTimer(1)
--在聊天框显示
Chat:sendSystemMsg("id为1的计时器开始正向计时！")
--在房主游戏界面显示id为1的计时器的计时
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为：",true)
Lua
pauseTimer
参数及类型：id:int计时器索引
返回值及类型：ErrorCode.OK
该方法的主要作用：暂停计时器具体使用案例如下：
--暂停id为1的计时器的计时，参数1就是计时器的id
MiniTimer:pauseTimer(1)
--在聊天框显示
Chat:sendSystemMsg("暂停了id为1的计时器！")
Lua
resumeTimer
参数及类型：id:int计时器索引
返回值及类型：ErrorCode.OK
该方法的主要作用：恢复计时器具体使用案例如下：
--恢复id为1的计时器的计时，参数1就是计时器的id
MiniTimer:resumeTimer(1)
--在聊天框显示
Chat:sendSystemMsg("恢复了id为1的计时器！")
--在房主游戏界面显示id为1的计时器的计时
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为：",true)
Lua
stopTimer
参数及类型：id:int计时器索引
返回值及类型：ErrorCode.OK
该方法的主要作用：停止计时器具体使用案例如下：
--停止id为1的计时器的计时，参数1就是计时器的id
MiniTimer:stopTimer(1)
--在聊天框显示
Chat:sendSystemMsg("停止了id为1的计时器！")
Lua
changeTimerTime
参数及类型：id:int计时器索引
time:int计时器计时
返回值及类型：ErrorCode.OK
该方法的主要作用：改变计时器计时具体使用案例如下：
local result = MiniTimer:changeTimerTime(id, curtime)
Lua
getTimerTime
参数及类型：id:int计时器索引
返回值及类型：ErrorCode.OK
second:int计时器运行时间
该方法的主要作用：获取计时器时间具体使用案例如下：
--在聊天框显示提示
Chat:sendSystemMsg("每次做动画表情都会显示id为1的计时器的计时时间！")
--当监听到动画表情时，执行此函数
local function showtime()
--获取id为1的计时器的计时时间，参数1就是计时器的id
local result,second=MiniTimer:getTimerTime(1)
--在聊天框显示
Chat:sendSystemMsg("id为1的计时器的计时时间为"..second)
end
--注册动画表情监听器，执行showtime函数
ScriptSupportEvent:registerEvent([=[Player.PlayAction]=],showtime)
Lua
showTimerWnd
参数及类型：
playerids:table玩家ID数组(nil表示全部玩家)
timerid:number计时器ID
title:string计时器窗口显示的标题
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 显示计时器窗口(若其他计时器已经显示，则替换显示)
具体使用案例如下：
local code = MiniTimer:showTimerWnd(playerids, timerid, title)
if code == ErrorCode.OK then
print('执行成功' )
else
print('执行失败')
end
Lua
hideTimerWnd
参数及类型：
playerids:table玩家ID数组(nil表示全部玩家)
timerid:number计时器ID
title:string计时器窗口显示的标题
返回值及类型：
code:number成功(ErrorCode.OK)ErrorCode
该方法的主要作用： 隐藏计时器窗口
具体使用案例如下：
local code = MiniTimer:hideTimerWnd(playerids, timerid)
if code == ErrorCode.OK then
print('执行成功' )
else
print('执行失败')
end等待时间1秒
threadpool:wait(1)
等待函数实例：
--等待1秒时间
function wait(time)
local v1 = time
if Trigger and Trigger.wait then
return Trigger:wait(v1)
end
wait(1)
end
拓展函数
threadpool:work(function() 函数体 end)
