目录— 个文件
⌕
目录加载中…
…/bridge/procedure/ProcedureInit.ts
1import { Runtime } from "../../runtime/Runtime";
2import { LoadingTag } from "../../runtime/manager/loading/define/LoadingDefine";
3import { PropType } from "../../runtime/system/prop/PropDefine";
4import { Framework } from "../../framework/Framework";
5import { ABExperimentKey } from "../ab/ABDefine";
6import { SdkChannel } from "../../framework/module/sdk/SdkChannel";
7import { SdkConfig } from "../../framework/module/sdk/SdkConfig";
8import { LaunchScene } from "../../framework/module/sdk/SdkDefine";
9import { SdkReportDefine } from "../sdk/SdkReportDefine";
10import { DataFrameKey } from "../../framework/core/data/DataFrameKey";
11import { ProcedureBase } from "../../framework/core/procedure/ProcedureBase";
12import { registerProcedure } from "../../framework/core/procedure/ProcedureClassRegistry";
13import { ProcudureEnum } from "./ProcudureEnum";
14import { ConfigName } from "../config/ConfigDefine";
15import type { GameGlobalRemoteConfig } from "../../runtime/manager/game/find/define/GameFindConfig";
16
17/**
18 * 初始化流程
19 * 初始化业务的所有系统
20 */
21@registerProcedure(ProcudureEnum.Init)
22export class ProcedureInit extends ProcedureBase {
23 procedureType = ProcudureEnum.Init;
24
25 // 显示名称由项目枚举提供,保持原日志名称。
26 get Name(): string {
27 return ProcudureEnum[this.procedureType];
28 }
29
30 Init() {
31 super.Init();
32 }
33
34 async Enter(args: any): Promise<void> {
35 // 登录和最终存档在 GameEntry 中完成,此处按配置、业务、启动统计的顺序初始化。
36 // ConfigManager 负责失败弹窗和重启;失败后结束本次启动,不再初始化业务。
37 const configsReady = await Framework.Config.LoadAllStartupConfigs();
38 if (!configsReady) return;
39
40 // 仅抖音读取项目群配置,保留原平台条件和业务初始化之前的调用位置。
41 if (SdkConfig.Channel === SdkChannel.Tiktok) {
42 const groupIds = Framework.Config.GetConfig<GameGlobalRemoteConfig>(ConfigName.GameGlobal).JoinGroupIds;
43 Framework.Sdk.InitGroup(groupIds);
44 }
45
46 //初始化道具系统
47 Runtime.Prop.Init();
48 //初始化货币系统
49 Runtime.Currency.Init();
50 //初始化收集系统
51 // Runtime.Collect.Init();
52 //初始化奖励系统
53 Runtime.Reward.Init();
54 //初始化新手引导系统
55 Runtime.Guide.Init();
56 //初始化七日签到
57 Runtime.Seven.Init();
58 //初始化红点
59 Runtime.RedDot.Init();
60 //初始化邀请系统
61 Runtime.Invitation.Init();
62 //初始化排行榜系统
63 Runtime.Rank.Init();
64 //初始化设置系统
65 Runtime.Setting.Init();
66 //初始化测试系统
67 Runtime.Test.Init();
68 //初始化独立智能自动游玩系统
69 Runtime.SmartAutoPlay.Init();
70 //初始化音频系统
71 Runtime.Audio.Init();
72 //初始化Feed系统
73 Runtime.Feed.Init();
74 //初始化分享系统
75 Runtime.Share.Init();
76 // 初始化每日挑战系统
77 Runtime.DailyChallenge.Init();
78 // 独立热点在配置与登录存档就绪后初始化。
79 Runtime.Hotspot.Init();
80 //初始化每日系统 放在最后 因为有每日重置事件会发送 要等其他system先注册事件
81 Runtime.Daily.Init();
82 //初始化成就系统
83 Runtime.Achievement.Init();
84
85 // 基础业务系统准备完成后,再初始化大厅和找物玩法。
86 //初始化游戏大厅管理器
87 Runtime.Lobby.Init();
88 //初始化找物体子游戏管理器
89 Runtime.GameFind.Init();
90
91 // 最终存档就绪后补记首次激活,早于业务广告。
92 Framework.Sdk.InitFirstActiveDate();
93 Framework.Sdk.ReportUserDailyActive();
94 Framework.Sdk.InitLifecycleReporting();
95 // 最终存档及玩法进度就绪后确定当天挑战用户分类。
96 Runtime.DailyChallenge.InitParticipationTracking();
97 this.Launch();
98 }
99
100 Leave(): void {
101 }
102
103 Update(deltaTime: number): void {
104 }
105
106 /** 启动游戏:最终存档已经确认,所有业务系统也只初始化了一次。 */
107 private Launch() {
108 const abTestVersion = this.InitLaunchABProperties();
109 Framework.Sdk.ReportAnalytic(SdkReportDefine.LaunchVersion.name, {
110 [SdkReportDefine.LaunchVersion.field.version]: Framework.Res.Config.BundleVersion,
111 });
112 if (abTestVersion) {
113 Framework.Sdk.ReportAnalytic(SdkReportDefine.ABTestGameEnter.name, {
114 [SdkReportDefine.ABTestGameEnter.field.test_id]: abTestVersion,
115 });
116 }
117
118 // 统计上下文准备完成后,再决定本次启动进入的场景。
119 let tagType: LoadingTag;
120 if (SdkConfig.Channel == SdkChannel.Tiktok) { //抖音渠道 存在推荐流的进入逻辑
121 const launchData = Framework.Sdk.TTSdkCtrl.LaunchData;
122 switch (launchData.scene) {
123 case LaunchScene.ttRecommond: //推荐流直出 直接送进游戏场景
124 // 启动时确定推荐流玩法类型,后续游戏流程只读取 GamePlayType。
125 Runtime.Feed.TryApplyForcedLevelOnGameStart(launchData);
126 tagType = LoadingTag.GameFind;
127 break;
128 default:
129 if (Runtime.Guide.Model.IsNewer) { //新用户 直接进游戏场景
130 tagType = LoadingTag.GameFind;
131 Runtime.Guide.SetIsNewer();
132 } else {
133 tagType = LoadingTag.Lobby;
134 }
135 break;
136 }
137 } else { //非抖音渠道走正常逻辑
138 if (Runtime.Guide.Model.IsNewer) { //新用户 直接进游戏场景
139 tagType = LoadingTag.GameFind;
140 Runtime.Guide.SetIsNewer();
141 } else {
142 tagType = LoadingTag.Lobby;
143 }
144 }
145
146 // 先准备埋点上下文,再进入可能命中缓存的加载流程。
147 this.MarkFirstLaunchStart(tagType);
148 Framework.Procedure.StartProcedure(ProcudureEnum.Loading, tagType);
149 }
150
151 /**
152 * 仅在每次启动时记录启动起点和目标场景,供 Loading 完成后统一上报耗时
153 */
154 private MarkFirstLaunchStart(launchScene: LoadingTag) {
155 let launchSceneStr: string;
156 switch (launchScene) {
157 case LoadingTag.GameFind:
158 launchSceneStr = SdkReportDefine.LaunchTime.launch_scene.gameScene;
159 break;
160 case LoadingTag.Lobby:
161 launchSceneStr = SdkReportDefine.LaunchTime.launch_scene.lobbyScene;
162 break;
163 }
164 Framework.Data.SaveData(DataFrameKey.EVERY_LAUNCH_REPORTED, false); // 启动时还原上报标识
165 const everyLaunchNum = Framework.Data.GetData<number>(DataFrameKey.EVERY_LAUNCH_NUM, 0);
166 Framework.Data.SaveData(DataFrameKey.EVERY_LAUNCH_NUM, everyLaunchNum + 1); // 累计冷启动次数,从 1 开始,不按日清除
167 Framework.Data.SaveData(DataFrameKey.EVERY_LAUNCH_START_MS, Framework.Sdk.LaunchStartMs); // 启动起始时间戳
168 Framework.Data.SaveData(DataFrameKey.EVERY_LAUNCH_SCENE, launchSceneStr); // 启动目标场景
169 }
170
171 /** 只为已参加主线实验的玩家准备启动属性,返回空字符串时不报实验进入事件。 */
172 private InitLaunchABProperties(): string {
173 let abTestVersion = "";
174 // 只有开启主线 AB 的马甲包才设置 AB 版本;A、B 两组均动态拼接当前 Bundle 版本号。
175 const mainlineReportGroup = Framework.AB.GetReportGroup(ABExperimentKey.MainlineLevelV1);
176 if (mainlineReportGroup) {
177 const isMainlineGroupB = mainlineReportGroup === "B";
178 // AB 属性与启动上报放在同一位置,固定 B 配置不参与实验埋点。
179 Framework.Sdk.SetSuperProperties({
180 [SdkReportDefine.mainlineABGroup]: isMainlineGroupB ? "B" : "A",
181 });
182 const versionSuffix = isMainlineGroupB
183 ? SdkReportDefine.ABTestGameEnter.versionSuffix.mainlineLevel
184 : SdkReportDefine.ABTestGameEnter.versionSuffix.normal;
185 abTestVersion = `${Framework.Res.Config.BundleVersion}${versionSuffix}`;
186 // 在首条启动事件前初始化四个公共属性,后续关卡、道具变化仍由现有系统实时更新。
187 Framework.Sdk.SetSuperProperties({
188 [SdkReportDefine.ABTestGameEnter.field.test_id]: abTestVersion,
189 [SdkReportDefine.levelId]: Runtime.GameFind.Level.CurrentLevel,
190 [SdkReportDefine.tipNum]: Runtime.Prop.GetPropNum(PropType.CommonTip),
191 [SdkReportDefine.heartNum]: Runtime.Prop.GetPropNum(PropType.CommonHeart),
192 });
193 }
194 return abTestVersion;
195 }
196}
讲解197 行
初始化流程人工通读
ProcedureInit.ts
启动链路里的初始化节点,注册为 ProcudureEnum.Init。它先等待全部启动配置加载成功,再按固定顺序初始化道具、货币、签到等业务系统,随后由 Launch 决定进入大厅还是找物场景,并切到 Loading 流程。
先看 Enter 里配置加载失败就 return 的前置判断,再想清楚 Daily 为什么放在最后初始化,最后读 Launch 的渠道与新用户分支。
特殊处理与易错点
- 易错点LoadAllStartupConfigs 返回 false 时直接 return,后续业务系统与 Launch 都不执行,失败弹窗和重启由配置管理器负责。L37
- 特殊处理Runtime.Daily.Init 被刻意放在最后,因为它会立即派发每日重置事件,必须等其他系统注册完监听。L80
- 特殊处理只有抖音渠道才读取 GameGlobal 配置并调用 InitGroup 初始化群配置,其他渠道整段跳过。L41
- 特殊处理抖音推荐流直出会先调用 TryApplyForcedLevelOnGameStart 固定本次玩法,再固定进入 GameFind 加载。L120
- 特殊处理首次激活、日活与生命周期上报放在业务系统初始化之后、Launch 之前,保证最终存档已就绪。L92
21注释初始化流程 初始化业务的所有系统
22注释ProcedureInit:初始化流程 初始化业务的所有系统
26方法以当前流程编号为键从 ProcudureEnum 取名称,供父类日志显示使用。
30方法只调用父类 Init 完成流程基类初始化,自身不追加逻辑。
34方法等待启动配置加载成功,抖音渠道初始化群配置,再按序初始化各业务系统并调用 Launch 启动。
37注释登录和最终存档在 GameEntry 中完成,此处按配置、业务、启动统计的顺序初始化。 ConfigManager 负责失败弹窗和重启;失败后结束本次启动,不再初始化业务。
41注释仅抖音读取项目群配置,保留原平台条件和业务初始化之前的调用位置。
47注释初始化道具系统
49注释初始化货币系统
53注释初始化收集系统 Runtime.Collect.Init(); 初始化奖励系统
55注释初始化新手引导系统
57注释初始化七日签到
59注释初始化红点
61注释初始化邀请系统
63注释初始化排行榜系统
65注释初始化设置系统
67注释初始化测试系统
69注释初始化独立智能自动游玩系统
71注释初始化音频系统
73注释初始化Feed系统
75注释初始化分享系统
77注释初始化每日挑战系统
79注释独立热点在配置与登录存档就绪后初始化。
81注释初始化每日系统 放在最后 因为有每日重置事件会发送 要等其他system先注册事件
83注释初始化成就系统
87注释基础业务系统准备完成后,再初始化大厅和找物玩法。 初始化游戏大厅管理器
89注释初始化找物体子游戏管理器
92注释最终存档就绪后补记首次激活,早于业务广告。
96注释最终存档及玩法进度就绪后确定当天挑战用户分类。
100方法空实现,离开初始化流程时不执行任何清理。
103方法空实现,初始化流程不参与每帧更新。
107方法上报版本与 AB 进入事件,按渠道与新手状态选定加载标记,记录启动信息后切到 Loading 流程。
119注释统计上下文准备完成后,再决定本次启动进入的场景。
125注释启动时确定推荐流玩法类型,后续游戏流程只读取 GamePlayType。
147注释先准备埋点上下文,再进入可能命中缓存的加载流程。
154方法把本次冷启动次数、起始时间戳与目标场景写入框架存档,并把已上报标识重置为 false。
172方法读取主线实验分组,命中时写入分组、版本与三项公共属性并返回带后缀版本号,否则返回空串。
175注释只有开启主线 AB 的马甲包才设置 AB 版本;A、B 两组均动态拼接当前 Bundle 版本号。
179注释AB 属性与启动上报放在同一位置,固定 B 配置不参与实验埋点。
187注释在首条启动事件前初始化四个公共属性,后续关卡、道具变化仍由现有系统实时更新。