找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/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 为什么把标识放在流程类的静态字段上。

特殊处理与易错点

10注释大厅流程
11注释ProcedureLobby:ProcedureLobby 是「流程桥」目录下的流程状态。描述一个游戏流程状态的进入、更新
15方法以当前流程编号为键从 ProcudureEnum 取名称,供父类日志显示使用。
20注释是否已上报 TrackMPLoadFinish(仅首次进入大厅/游戏时上报一次)
22方法只调用父类 Init 完成流程基类初始化,自身不追加逻辑。
26方法调用 Runtime.Lobby.Enter 进入大厅,首次上报加载完成埋点,再预加载当前关卡资源。
32注释预加载当前关卡
35方法调用 Runtime.Lobby.Leave 让大厅管理器释放或隐藏大厅相关内容。
39方法空实现,大厅流程不参与每帧更新。
42方法静态标识为 false 时置为 true 并调用 TrackMPLoadFinish,已上报则直接返回。