Time

Игровые часы: как быстро идёт игра и сколько стоит кадр. Time.scale замедляет или ускоряет всю игру, Time.paused её замораживает, и оба действуют на физику, аниматоры и частицы. Задержки по реальному времени в приложении — это setTimeout / setInterval (глобалы); даты — date (Даты).

  • поставить игру на паузу и заморозить физику и анимации
  • оставить меню паузы анимированным, пока игра стоит
  • замедлить или ускорить всю игру
  • двигать объект на дельту времени кадра
  • выполнять логику с фиксированным шагом 60 Гц
  • узнать игровое время или число кадров с запуска

Платформы: все хосты. В чисто 2D-приложении (без 3D Scene) на Android, в безоконном сервере (lecodes serve) и в headless-тестах часы запускаются, только когда 2D-движок начал загружать текстуру, — до этого Time.frame остаётся 0 и ни один update не выполняется.

Обзор

TypeScript
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

TypeScript
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 на паузе. Умножай на него скорости — и движение одинаково при любой частоте кадров.

TypeScript
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.

TypeScript
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