Time
Игровые часы: как быстро идёт игра и сколько стоит кадр. Time.scale замедляет или ускоряет всю
игру, Time.paused её замораживает, и оба действуют на физику, аниматоры и частицы. Задержки по
реальному времени в приложении — это setTimeout / setInterval (глобалы);
даты — date (Даты).
- поставить игру на паузу и заморозить физику и анимации
- оставить меню паузы анимированным, пока игра стоит
- замедлить или ускорить всю игру
- двигать объект на дельту времени кадра
- выполнять логику с фиксированным шагом 60 Гц
- узнать игровое время или число кадров с запуска
Платформы: все хосты. В чисто 2D-приложении (без 3D Scene) на Android, в безоконном сервере
(lecodes serve) и в headless-тестах часы запускаются, только когда 2D-движок начал загружать
текстуру, — до этого Time.frame остаётся 0 и ни один update не выполняется.
Обзор
class PauseMenu extends System<'pauseMenu'> {
updateWhilePaused = true // продолжает тикать, пока мир заморожен
fade = 0
private onKey = (e: InputKeyEvent) => { if (e.code === 'Escape' && !e.repeat) Time.paused = !Time.paused }
onAttach() { Input.on('keydown', this.onKey) }
onDetach() { Input.off('keydown', this.onKey) }
update() { // на паузе dt равен 0: берём реальное время
this.fade = Time.paused ? Math.min(1, this.fade + Time.unscaledDt * 4) : 0
}
}
const scene = new Scene().system(PauseMenu)
scene.open()
Time.scale = 0.25 // замедление для kill camСвойства игровых часов: Time.dt, now, scale, paused
Time.scale: number // 1 нормально · 0.5 половина скорости · 2 двойная (≤ 0 / NaN / Infinity → 0, заморожено)
Time.paused: boolean // заморозить игру; `scale` запоминается и восстанавливается при снятии паузы
Time.effectiveScale: number // множитель, с которым движки работают прямо сейчас (0 на паузе; только чтение)
Time.dt: number // дельта этого кадра в ИГРОВЫХ секундах — то, что получает update(dt); 0 на паузе
Time.unscaledDt: number // дельта этого кадра по реальному времени, секунды (движки ограничивают её до 0.05)
Time.fixedDt: number // 1/60 — то, что всегда получает updateFixed(dt) (только чтение)
Time.now: number // игровые секунды с запуска часов (масштабированные; стоят на паузе)
Time.unscaledNow: number // секунды реального времени с запуска часов
Time.frame: number // кадров отправлено с запуска часов (кадры на паузе считаются)Дельта времени кадра: update(dt)
update(dt) / updateBefore(dt) получают Time.dt: игровые секунды, умноженные на Time.scale,
0 на паузе. Умножай на него скорости — и движение одинаково при любой частоте кадров.
class Spinner extends Aspect<'spinner', Sprite> {
speed = 90 // градусов за ИГРОВУЮ секунду
update(dt: number) { // dt = Time.dt: замедляется с Time.scale, 0 на паузе
this.node.rotation += this.speed * dt
}
}
const scene = new Scene2D()
scene.add(new Sprite({ size: [40, 40], color: '#4f7cff' }).aspect(Spinner))
scene.open()Часы приводит в движение диспетчер аспектов, который запускается с первым
аспектом или системой, где определён метод update: до этого dt, now и frame остаются 0.
Пауза в игре, а меню паузы анимируется: Time.paused, updateWhilePaused
Time.paused = true ставит игру на паузу: физика, аниматоры и частицы останавливаются, и все
обновляющие пропускаются, кроме тех, у кого updateWhilePaused = true, — там продолжает
анимироваться затухание меню паузы. Они вызываются с dt = 0 и сами читают Time.unscaledDt — то
же разделение, что deltaTime / unscaledDeltaTime в Unity (меню паузы из Обзора).
Фиксированный шаг: updateFixed и Time.fixedDt
updateFixed(dt) всегда получает Time.fixedDt (1/60); scale меняет, сколько фиксированных
шагов приходится на кадр, но никогда не их длину. На паузе их нет — даже для updateWhilePaused.
class Drift extends Aspect<'drift', Sprite> {
speed = 120 // пикселей за игровую секунду
updateFixed(dt: number) { // dt всегда равен Time.fixedDt (1/60)
this.node.x += this.speed * dt
}
}
const scene = new Scene2D()
scene.add(new Sprite({ size: [32, 32], color: '#ff7a45' }).aspect(Drift))
scene.open()Замедление физики, аниматоров и частиц: Time.scale
Масштаб передаётся каждому движку через его бридж setTimeScale (если он есть): шаги физики, часы
аниматоров и системы частиц продвигаются на dt × scale. На хосте, чей движок старше этого хука,
симуляции идут в реальном времени, хотя игровой код масштабируется, — там останавливай тела сам.
Твины на часах 'game' (animate) берут масштаб 3D-движка: они
замедляются и встают на паузу вместе с Time, только когда существует 3D Scene. В чисто 2D- или
UI-приложении, в вебе и в headless-тестах твин на 'game' идёт в реальном времени.
Таймеры не на игровых часах: setTimeout, setLoop
setTimeout / setInterval / setLoop — таймеры хоста в реальном времени: они не
масштабируются и не ставятся на паузу вместе с Time (глобалы).
Задержку, которая должна стоять, пока игра на паузе, отсчитывай по dt в аспекте или системе.
Смотрите также
- Аспекты —
updateWhilePaused, фазы, потребляющиеdt - Input —
Input.on('keydown')для одиночных нажатий вроде переключения паузы - Глобалы хоста —
setLoop,setTimeout