目录— 个文件
⌕
目录加载中…
…/bridge/procedure/ProcedureLobby.ts
1import { Runtime } from "../../runtime/Runtime";
2import { Framework } from "../../framework/Framework";
3import { ProcedureBase } from "../../framework/core/procedure/ProcedureBase";
4import { registerProcedure } from "../../framework/core/procedure/ProcedureClassRegistry";
5import { ProcudureEnum } from "./ProcudureEnum";
6
7/**
8 * 大厅流程
9 */
10@registerProcedure(ProcudureEnum.Lobby)
11export class ProcedureLobby extends ProcedureBase {
12 procedureType = ProcudureEnum.Lobby;
13
14 // 显示名称由项目枚举提供,保持原日志名称。
15 get Name(): string {
16 return ProcudureEnum[this.procedureType];
17 }
18
19 /** 是否已上报 TrackMPLoadFinish(仅首次进入大厅/游戏时上报一次) */
20 private static loadFinishReported: boolean = false;
21
22 Init() {
23 super.Init();
24 }
25
26 Enter(args: any): void {
27 Runtime.Lobby.Enter();
28
29 this.ReportLoadFinishOnce();
30
31 //预加载当前关卡
32 Runtime.Preload.PreloadCurrentLevel();
33 }
34
35 Leave(): void {
36 Runtime.Lobby.Leave();
37 }
38
39 Update(deltaTime: number): void {
40 }
41
42 private ReportLoadFinishOnce(): void {
43 if (ProcedureLobby.loadFinishReported) return;
44 ProcedureLobby.loadFinishReported = true;
45 Framework.Sdk.TrackMPLoadFinish();
46 }
47}
讲解48 行
大厅流程人工通读
ProcedureLobby.ts
大厅场景对应的流程节点,注册为 ProcudureEnum.Lobby。进入时驱动 Runtime.Lobby 加载大厅、首次上报加载完成埋点并预加载当前关卡;离开时只调用 Runtime.Lobby.Leave 做清理。
先看 Enter 三步的顺序,再看 ReportLoadFinishOnce 为什么把标识放在流程类的静态字段上。
特殊处理与易错点
- 特殊处理loadFinishReported 是静态字段,进程内只会调用一次 TrackMPLoadFinish,重启场景不会重置。L20
- 易错点PreloadCurrentLevel 依赖 Lobby.Enter 已准备好当前关卡数据,调换顺序会预加载错误关卡。L32
- 设计Enter 与 Leave 只代理 Runtime.Lobby 的进出,流程类本身不持有大厅 UI 或业务数据。L11
10注释大厅流程
11注释ProcedureLobby:ProcedureLobby 是「流程桥」目录下的流程状态。描述一个游戏流程状态的进入、更新
15方法以当前流程编号为键从 ProcudureEnum 取名称,供父类日志显示使用。
20注释是否已上报 TrackMPLoadFinish(仅首次进入大厅/游戏时上报一次)
22方法只调用父类 Init 完成流程基类初始化,自身不追加逻辑。
26方法调用 Runtime.Lobby.Enter 进入大厅,首次上报加载完成埋点,再预加载当前关卡资源。
32注释预加载当前关卡
35方法调用 Runtime.Lobby.Leave 让大厅管理器释放或隐藏大厅相关内容。
39方法空实现,大厅流程不参与每帧更新。
42方法静态标识为 false 时置为 true 并调用 TrackMPLoadFinish,已上报则直接返回。