70 lines
1.7 KiB
TypeScript
70 lines
1.7 KiB
TypeScript
|
import Phaser from 'phaser';
|
|||
|
|
import { effect } from '@preact/signals-core';
|
|||
|
|
import { DisposableBag, type IDisposable } from '../utils';
|
|||
|
|
|
|||
|
|
type CleanupFn = void | (() => void);
|
|||
|
|
|
|||
|
|
export interface PhaserGameContext {
|
|||
|
|
game: Phaser.Game;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface ReactiveScenePhaserData {
|
|||
|
|
phaserGame: PhaserGameContext;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface ReactiveSceneOptions<TData extends Record<string, unknown> = {}> {
|
|||
|
|
key?: string;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 通用的响应式 Scene 基类
|
|||
|
|
* @typeparam TData - 通过 init(data) 接收的数据类型（必须包含 phaserGame）
|
|||
|
|
*/
|
|||
|
|
export abstract class ReactiveScene<TData extends Record<string, unknown> = {}>
|
|||
|
|
extends Phaser.Scene
|
|||
|
|
implements IDisposable
|
|||
|
|
{
|
|||
|
|
protected disposables = new DisposableBag();
|
|||
|
|
private _initData!: TData & ReactiveScenePhaserData;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 获取通过 init() 注入的数据
|
|||
|
|
* 在 create() 阶段保证可用
|
|||
|
|
*/
|
|||
|
|
public get initData(): TData & ReactiveScenePhaserData {
|
|||
|
|
return this._initData;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 获取 Phaser game 实例的响应式信号
|
|||
|
|
*/
|
|||
|
|
public get phaserGame(): PhaserGameContext {
|
|||
|
|
return this._initData.phaserGame;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
constructor(key?: string) {
|
|||
|
|
super(key);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
init(data: TData & ReactiveScenePhaserData): void {
|
|||
|
|
this._initData = data;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
create(): void {
|
|||
|
|
this.events.on('shutdown', this.dispose, this);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
dispose(): void {
|
|||
|
|
this.disposables.dispose();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public addDisposable(disposable: IDisposable): void {
|
|||
|
|
this.disposables.add(disposable);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 注册响应式监听（场景关闭时自动清理） */
|
|||
|
|
public addEffect(fn: () => CleanupFn): void {
|
|||
|
|
this.disposables.add(effect(fn));
|
|||
|
|
}
|
|||
|
|
}
|