A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
import {
defineSystem, Query, Mut, Res, UIEvents, Audio, Text,
} from 'esengine';
import type { UIEventQueue, AudioAPI } from 'esengine';
import { VolumeKnob, VolumeLabel } from '../components';
import { VOLUME_STEPS } from '../config';
import { loadBusVolumes, saveBusVolumes, type BusVolumes } from '../settings';
import { VOLUME_BUSES, type VolumeBus } from '../volumeSettings';
function applyBusVolume(audio: AudioAPI, bus: string, v: number): void {
if (bus === 'master') audio.setMasterVolume(v);
else if (bus === 'music') audio.setMusicVolume(v);
else if (bus === 'sfx') audio.setSFXVolume(v);
}
const cap = (s: string): string => s.charAt(0).toUpperCase() + s.slice(1);
export const restoreVolumeSystem = defineSystem(
[Res(Audio), Query(Mut(VolumeKnob)), Query(Mut(Text), VolumeLabel)],
(audio: AudioAPI, knobs, labels) => {
const volumes = loadBusVolumes();
for (const [, knob] of knobs) {
if (!VOLUME_BUSES.includes(knob.bus as VolumeBus)) continue;
knob.volume = volumes[knob.bus as keyof BusVolumes];
applyBusVolume(audio, knob.bus, knob.volume);
}
for (const [, text, label] of labels) {
text.content = `${cap(label.bus)} ${Math.round((volumes[label.bus as keyof BusVolumes] ?? 1) * 100)}%`;
}
},
{ name: 'RestoreVolumeSystem' },
);
// Clicking a knob steps its bus volume through VOLUME_STEPS; labels mirror each
// bus's current level.
export const volumeSystem = defineSystem(
[Res(UIEvents), Res(Audio), Query(Mut(VolumeKnob)), Query(Mut(Text), VolumeLabel)],
(events: UIEventQueue, audio: AudioAPI, knobs, labels) => {
const clicks = events.query('click');
const vol: Record<string, number> = {};
let changed = false;
for (const [entity, knob] of knobs) {
if (clicks.some((c) => c.target === entity)) {
const next = (VOLUME_STEPS.indexOf(knob.volume) + 1) % VOLUME_STEPS.length;
knob.volume = VOLUME_STEPS[next] ?? 1;
applyBusVolume(audio, knob.bus, knob.volume);
changed = true;
}
vol[knob.bus] = knob.volume;
}
if (changed) {
saveBusVolumes({ master: vol.master ?? 1, music: vol.music ?? 1, sfx: vol.sfx ?? 1 });
for (const [, text, label] of labels) {
text.content = `${cap(label.bus)} ${Math.round((vol[label.bus] ?? 1) * 100)}%`;
}
}
},
{ name: 'VolumeSystem' },
);