找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/scripts/framework/Framework.ts
1import { DataManager } from "./core/data/DataManager";
2import { EventManager } from "./core/event/EventManager";
3import { TsrpcManager } from "./core/http/TsrpcManager";
4import { LogManager } from "./core/log/LogManager";
5import { AudioManager } from "./core/music/AudioManager";
6import { ObjectPoolManager } from "./core/objectPool/ObjectPoolManager";
7import { ProcedureManager } from "./core/procedure/ProcedureManager";
8import { ResourceManager } from "./core/resource/ResourceManager";
9import { SceneManager } from "./core/scene/SceneManager";
10import { TimerManager } from "./core/timer/TimerManager";
11import { UIManager } from "./core/ui/UIManager";
12import { VersionManager } from "./core/version/VersionManager";
13import { ABManager } from "./module/ab/ABManager";
14import { ConfigManager } from "./core/config/ConfigManager";
15import { LoginManager } from "./module/login/LoginManager";
16import { PackageManager } from "./module/package/PackageManager";
17import { SdkManager } from "./module/sdk/SdkManager";
18import { ServerManager } from "./module/server/ServerManager";
19
20/**
21 * 框架层单例合集
22 */
23export class Framework {
24 //流程管理器
25 static get Procedure(): ProcedureManager {
26 return ProcedureManager.Instance<ProcedureManager>();
27 }
28
29 //场景管理器
30 static get Scene(): SceneManager {
31 return SceneManager.Instance<SceneManager>();
32 }
33
34 //UI管理器
35 static get UI(): UIManager {
36 return UIManager.Instance<UIManager>();
37 }
38
39 //音乐管理器
40 static get Audio(): AudioManager {
41 return AudioManager.Instance<AudioManager>();
42 }
43
44 //日志管理器
45 static get Log(): LogManager {
46 return LogManager.Instance<LogManager>();
47 }
48
49 //事件管理器
50 static get Event(): EventManager {
51 return EventManager.Instance<EventManager>();
52 }
53
54 //资源加载器
55 static get Res(): ResourceManager {
56 return ResourceManager.Instance<ResourceManager>();
57 }
58
59 //对象池管理器
60 static get Pool(): ObjectPoolManager {
61 return ObjectPoolManager.Instance<ObjectPoolManager>();
62 }
63
64 //定时器
65 static get Timer(): TimerManager {
66 return TimerManager.Instance<TimerManager>();
67 }
68
69 //数据存储
70 static get Data(): DataManager {
71 return DataManager.Instance<DataManager>();
72 }
73 //TSRPC 管理器
74 static get Tsrpc(): TsrpcManager {
75 return TsrpcManager.Instance<TsrpcManager>();
76 }
77 //版本号管理器
78 static get Version(): VersionManager {
79 return VersionManager.Instance<VersionManager>();
80 }
81
82 //***通用模块*******************************************************************************************************************//
83
84 // AB 测试管理器
85 static get AB(): ABManager {
86 return ABManager.Instance<ABManager>();
87 }
88
89 //SDK管理器
90 static get Sdk(): SdkManager {
91 return SdkManager.Instance<SdkManager>();
92 }
93
94 //马甲包管理器
95 static get Package(): PackageManager {
96 return PackageManager.Instance<PackageManager>();
97 }
98
99 //配置管理器
100 static get Config(): ConfigManager {
101 return ConfigManager.Instance<ConfigManager>();
102 }
103
104 //平台与自建服务器登录
105 static get Login(): LoginManager {
106 return LoginManager.Instance<LoginManager>();
107 }
108
109 //自建服务器 API 统一入口
110 static get Server(): ServerManager {
111 return ServerManager.Instance<ServerManager>();
112 }
113
114}
讲解115 行
框架门面人工通读

Framework.ts

全局静态门面,把 18 个管理器的单例用只读 getter 暴露给业务。它自身不保存任何状态,只做转发,所以读它是为了确认某个管理器归谁所有、名字叫什么。

先看上半部分的框架核心管理器,再看下半部分带“通用模块”注释的业务管理器,最后回到 FrameworkEntry 看它们的初始化顺序。

特殊处理与易错点

  • 特殊处理不要绕过门面直接 new 管理器:只有进入 FrameworkEntry.managerArray 的实例才会被 Init/Update/DeInit,手工 new 出来的实例不会参与每帧更新。
23注释Framework:框架层单例门面,集中暴露流程、场景、UI、资源、事件、存档、音频、日志等 core 管理器与
25方法返回流程管理器单例,负责 Loading/Init/Lobby/Game 之间的切换与流程内更新。
30方法返回场景管理器单例,负责场景加载、切换与场景根节点的维护。
35方法返回 UI 管理器单例,负责面板的打开、关闭、缓存与分组显示。
40方法返回音频管理器单例,负责背景音乐、音效播放与前后台切换时的处理。
45方法返回日志管理器单例,统一控制日志开关与输出前缀。
50方法返回事件总线单例,业务通过它注册与派发全局事件。
55方法返回资源管理器单例,负责 bundle 与资源的加载、缓存和释放。
60方法返回对象池管理器单例,负责节点池的创建、回收与复用。
65方法返回定时器管理器单例,由框架统一驱动的延时与循环计时。
70方法返回存档管理器单例,负责本地存档读写、版本校对与延迟上传服务器。
74方法返回 TSRPC 客户端管理器单例,负责长连接建立、断线重连与消息收发。
78方法返回版本管理器单例,负责客户端版本号与资源版本信息。
85方法返回 AB 实验管理器单例,负责实验分桶与取值。
90方法返回 SDK 管理器单例,按渠道适配抖音、微信、支付宝、京东等平台能力。
95方法返回马甲包管理器单例,负责发行包标识与包级配置切换。
100方法返回配置管理器单例,负责配置表的加载与按 ID 查询。
105方法返回登录管理器单例,负责平台登录与自建服务器登录的串联。
110方法返回服务器管理器单例,是所有自建服务器接口的统一调用入口。