主站
道具百科
触发器百科
脚本API百科
创作手册
创作功能
其他
Studio百科
计时器接口: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(...)
隐藏计时器窗口

isExist

  • 参数及类型:

  • 返回值及类型:

  • 该方法的主要作用:判断计时器是否存在

  • 具体使用案例如下:

--判断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

createTimer

  • 参数及类型:

  • 返回值及类型:

  • 该方法的主要作用:添加计时器

  • 具体使用案例如下:

--创建一个新计时器,命名为“timer”
--第一个参数就是创建的计时器的名字,第二个参数是地图id(作用不明,默认不传),第三个参数是是否为存档私有计时器(改为false则所有存档可共用此计时器。默认不传)
local result,id=MiniTimer:createTimer("timer",nil,true)
--在聊天框显示
Chat:sendSystemMsg("新建了名为“timer”的计时器,id为"..id)

deleteTimer

  • 参数及类型:

  • 返回值及类型:

  • 该方法的主要作用:删除计时器

  • 具体使用案例如下:

--删除id为1的计时器。参数为要删除的计时器的id
MiniTimer:deleteTimer(1)
--在聊天框显示
Chat:sendSystemMsg("删除了id为1的计时器!")

startBackwardTimer

  • 参数及类型:

    • id:int计时器索引
    • interval:int倒计时间隔时间
    • repeated:bool是否重复执行
  • 返回值及类型:

  • 该方法的主要作用:启动倒计时

  • 具体使用案例如下:

--让id为1的计时器开始20秒倒计时
--第一个参数为计时器id,第二个参数为倒计时时间,第三个参数为是否重复执行(貌似无效)
MiniTimer:startBackwardTimer(1,20,false)
--在聊天框显示
Chat:sendSystemMsg("启动了id为1的计时器,倒计时20秒!")
--在房主游戏界面显示id为1的计时器的计时
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为:",true)

startForwardTimer

  • 参数及类型:

    • id:int计时器索引
  • 返回值及类型:

  • 该方法的主要作用:启动正向计时

  • 具体使用案例如下:

--让id为1的计时器递增计时,参数1就是计时器id
MiniTimer:startForwardTimer(1)
--在聊天框显示
Chat:sendSystemMsg("id为1的计时器开始正向计时!")
--在房主游戏界面显示id为1的计时器的计时
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为:",true)

pauseTimer

  • 参数及类型:

    • id:int计时器索引
  • 返回值及类型:

  • 该方法的主要作用:暂停计时器

  • 具体使用案例如下:

--暂停id为1的计时器的计时,参数1就是计时器的id
MiniTimer:pauseTimer(1)
--在聊天框显示
Chat:sendSystemMsg("暂停了id为1的计时器!")

resumeTimer

  • 参数及类型:

    • id:int计时器索引
  • 返回值及类型:

  • 该方法的主要作用:恢复计时器

  • 具体使用案例如下:

--恢复id为1的计时器的计时,参数1就是计时器的id
MiniTimer:resumeTimer(1)
--在聊天框显示
Chat:sendSystemMsg("恢复了id为1的计时器!")
--在房主游戏界面显示id为1的计时器的计时
MiniTimer:showTimerTips({0},1,"id为1的计时器的计时为:",true)

stopTimer

  • 参数及类型:

    • id:int计时器索引
  • 返回值及类型:

  • 该方法的主要作用:停止计时器

  • 具体使用案例如下:

--停止id为1的计时器的计时,参数1就是计时器的id
MiniTimer:stopTimer(1)
--在聊天框显示
Chat:sendSystemMsg("停止了id为1的计时器!")

changeTimerTime

  • 参数及类型:

    • id:int计时器索引
    • time:int计时器计时
  • 返回值及类型:

  • 该方法的主要作用:改变计时器计时

  • 具体使用案例如下:

local result = MiniTimer:changeTimerTime(id, curtime)

getTimerTime

  • 参数及类型:

    • id: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)

 

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

 

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

站点有内容要更新是否更新。
更新
忽略