Системы
Система — поведение всей СЦЕНЫ: ввод, игровой режим, спавнер, HUD, пулы эффектов — логика, у
которой нет одного узла, где жить; подключается через scene.system(Class). Поведение ОДНОГО узла
(дверь, враг, подбираемый предмет) — это аспект; ни то ни другое не
пишется как самодельный цикл на setLoop / tick().
- читать клавиатуру раз за кадр для всей игры
- вести игровой режим или спавнер на всю сцену
- показывать HUD, который обновляется каждый кадр
- держать один пул частиц на все объекты сцены
- заменить самодельный игровой цикл или
tick() - выбрать между системой и аспектом
Платформы: iOS, Android, десктоп, веб (Web Lite), веб-плеер, headless-тесты.
Обзор
class Controls extends System<'controls'> {
moveX = 0; moveY = 0; fire = false
updateBefore() { // РАНО: опрашиваем до шага симуляции
this.moveX = (Input.key('KeyD') ? 1 : 0) - (Input.key('KeyA') ? 1 : 0)
this.moveY = (Input.key('KeyW') ? 1 : 0) - (Input.key('KeyS') ? 1 : 0)
this.fire = Input.key('MouseLeft')
}
}
class Hud extends System<'hud', Scene, { announce: (text: string) => void }> {
static after = [Controls]
private banner = UIText('').style({ fontSize: 30, color: '#ffffff' })
onAttach() { this.scene.widgets.append(UIWidget(this.banner).style({ left: '50%', top: '20%' })) }
announce(text: string) { this.banner.text = text; this.emit('announce', text) }
update(dt: number) { this.banner.style.opacity = this.scene.get(Controls)!.fire ? 0.5 : 1 }
}
const scene = new Scene().system(Controls).system(Hud)
scene.open()
scene.hud.on('announce', (t) => console.log('[hud]', t))
scene.hud.announce('ROUND 1')Добавить систему в сцену: scene.system, get, removeSystem
scene.system(Class, opts) прикрепляет систему к сцене и даёт ей имя на сцене:
scene.system(Fx) → scene.fx.
scene.system(Class, opts?): scene & { name: instance } // СОЗДАТЬ систему из opts (каждый раз новый экземпляр)
scene.get(Class): instance | undefined // безопасный доступ
scene.has(Class): boolean // проверка существования И type guard
scene.removeSystem(Class): scene // открепить (выполняет onDetach); можно продолжать цепочку
scene.destroy(): void // все системы открепляются, затем сцена закрывается
Aspect.all(Class): readonly instance[] // системы регистрируются так же, как аспектыТе же правила, что у node.aspect(): имя аксессора берётся из первого generic-параметра, opts
присваиваются до onAttach, второй system(Class, opts) открепляет первую систему и создаёт новую
ровно из этих opts (живое значение меняй записью в scene.<accessor>), а аксессор типизирован на
результате цепочки (const scene = new Scene().system(Hud) → scene.hud). destroy() открепляет
системы в обратном порядке — последняя прикреплённая первой, — пока сцена ещё существует; Scene2D
затем уничтожается и нативно, 3D Scene закрывается, а её узлы остаются твоими.
Система вместо игрового цикла: class … extends System
Система заменяет самодельный игровой цикл — класс «game», чей tick() по порядку вызывает всё
остальное. У неё ровно тот же жизненный цикл, что у аспекта (onAttach /
onDetach, dirty() / flush(), updateBefore / updateFixed / update, updateOrder /
static after, события), только прикрепляется она к сцене, а не к узлу.
class Fx extends System<'fx'> { // <имя аксессора, вид сцены = Scene, события = {}>
private sparks!: Particles
onAttach() { // this.scene — сцена, к которой прикрепили
this.sparks = new Particles({ blend: 'add', rate: 0, lifetime: 0.4, size: 0.05 })
this.scene.add(this.sparks)
}
onDetach() { this.sparks.destroy() }
impact(p: Vec3) { this.sparks.position = p; this.sparks.spawn(20) }
}this.scene(иthis.node— тот же объект) — это сцена, типизированная вторым generic:System<'fx'>работает с 3DScene,System<'fx', Scene2D>— с 2D. Прикрепить 2D-систему к 3D-сцене (или наоборот) — ошибка компиляции.- Внутри системы
this.sceneтипизирован как простой вид сцены, без аксессоров других систем: доставай их черезthis.scene.get(Controls)!. - Системы создаёт
scene.system(), никогда неnew— конструктора нет; инициализируй вonAttach. - Порядок систем и аспектов — один общий список на фазу:
static after = [Controls]на аспекте может ссылаться на систему и наоборот (см. aspects.md).
Система или аспект: что выбрать
| Аспект (на узле) | Система (на сцене) | |
|---|---|---|
| Владеет | поведением / состоянием одного узла | состоянием всей сцены, пулами, сервисами |
| Примеры | Health, ExplosiveBarrel, PlayerController, CameraFollow |
Controls, Fx, Hud, GameMode, Spawner |
| Находится через | node.get(Ctor), Aspect.all(Ctor), use() в файле сцены |
scene.get(Ctor), scene.fx |
| Время жизни | до removeAspect / node.destroy() |
до removeSystem / scene.destroy() |
Не навешивай общесценовое на узел-пустышку («пустой узел с аспектом Loop»): для этого и есть система. Но и не превращай состояние отдельного объекта в систему — hp бочки живёт на бочке.
Смотрите также
- Аспекты — фазы, порядок, события (всё общее с системами)
- Time — пауза / масштаб времени
- Архитектура проекта — целая игра из систем и аспектов