迷你世界脚本计时器接口：MiniTimer

计时器接口：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)