Appearance
地图信息
属性
projectName
本张地图名称,对应项目设置中的名称。
## serverId
当前服务器 ID
可通过teleport
生成服务器 ID。
## currentTick
默认值:0
世界当前的 Tick 计数。
url
获取当前地图所在的 URL 链接地址。
方法
onTick()
这是世界的计时事件,每 64 毫秒触发一次,Tick 计数加 1。
监听此事件可以让世界以 64 毫秒为间隔循环执行代码。
在理想情况下,每 Tick 为 64 毫秒。若网络发生延迟,可能会有变化。
输入参数
参数 | 必填 | 默认值 | 类型 | 说明 |
---|---|---|---|---|
handler | 是 | function | 每 64 毫秒触发的处理函数 |
点击查看示例代码
javascript
// 监听此事件,会在控制台持续输出 tick 计数
world.onTick(({ tick }) => {
console.log("tick " + tick);
});
javascript
// 当玩家进入地图
world.onPlayerJoin(({ entity }) => {
// 每Tick的间隔向控制台输出提示
const token = world.onTick(() => {
console.log("tick !");
}); // 2秒后,结束事件
setTimeout(() => {
console.log("cancel tick handler");
token.cancel(); // 不再记录tick事件
}, 2000);
});
接口
GameTickEvent
每一刻(tick)触发一次的事件
参数 | 类型 | 说明 |
---|---|---|
tick | number | 事件发生时间 |
prevTick | number | 上一个已处理的时刻 |
elapsedTimeMS | number | 两个时刻之间的时间间隔(毫秒) |
skip | boolean | 是否因为延迟而跳过了某些 Tick |